jooto-cli

Jooto API の CLI ツール。Go 製のシングルバイナリで、タスク・プロジェクト管理をコマンドラインから操作できます。

> Jooto エンタープライズプランの API キーが必要です。

インストール

対応プラットフォーム

| OS | Arch | | --- | --- | | macOS (darwin) | arm64 (Apple Silicon) | | Linux | arm64, amd64 |

インストールスクリプト（推奨）

curl -sfL https://raw.githubusercontent.com/PRTIMES/jooto-cli/main/install.sh | sh

インストール先を変更する場合は INSTALL_DIR を指定します:

curl -sfL https://raw.githubusercontent.com/PRTIMES/jooto-cli/main/install.sh | INSTALL_DIR=~/.local/bin sh

GitHub CLI で手動ダウンロード

gh release download --repo PRTIMES/jooto-cli --pattern '*_darwin_arm64.tar.gz'
tar -xzf jooto_darwin_arm64.tar.gz
sudo mv jooto /usr/local/bin/

ソースからビルドしてインストール

開発用途やリリース前の動作確認には、ローカルビルド & インストールを参照してください。

セットアップ

プロファイルの登録

API キーをプロファイルとして登録します。登録時に組織情報が自動取得されます。

jooto profile add <プロファイル名> <API キー>

複数のプロファイルを登録して切り替えられます:

jooto profile add work "api-key-for-work"
jooto profile add personal "api-key-for-personal"
jooto profile use work           # デフォルトプロファイルを設定
jooto profile list               # 登録済みプロファイル一覧
jooto profile show [name]        # プロファイル詳細を表示
jooto profile remove <name>      # プロファイルを削除

設定ファイルは ~/.config/jooto/config.toml に保存されます。

プロファイルの選択順序

API キーは以下の優先順位で決定されます:

1. --profile=<name> フラグ 2. 環境変数 JOOTO_PROFILE 3. config.toml の default_profile

使い方

jooto <object> <action> [arguments] [options]

すべてのコマンドは JSON を stdout に出力します。エラーは stderr に出力し、終了コード 1 で終了します。

jooto help                    # コマンド一覧
jooto help <object>           # オブジェクトのアクション一覧
jooto help <object> <action>  # アクションの詳細ヘルプ
jooto version                 # バージョン表示

コマンド一覧

組織・ユーザー

| コマンド | 説明 | | --- | --- | | org get | 組織情報を取得する | | user list | ユーザー一覧を取得する | | user get <id> | ユーザー情報を取得する |

プロジェクト

| コマンド | 説明 | | --- | --- | | board list [--archived\|--active] | プロジェクト一覧を取得する | | board create <title> [description] | プロジェクトを新規作成する | | board update <board_id> [options] | プロジェクト情報を更新する | | board delete <board_id> | プロジェクトを削除する | | member list <board_id> | メンバー一覧を取得する |

| コマンド | 説明 | | --- | --- | | list list <board_id> [--archived] | リスト一覧を取得する | | list create <board_id> <name> [color] | リストを作成する | | list update <board_id> <list_id> [options] | リスト情報を更新する | | list delete <board_id> <list_id> | リストを削除する | | list reorder <board_id> <id1,id2,...> | リスト順序を変更する |

タスク

| コマンド | 説明 | | --- | --- | | task list <board_id> [options] | 条件でタスク一覧を絞り込む | | task get <board_id> <task_id> | タスク情報を取得する | | task create <board_id> <list_id> <name> [options] | タスクを作成する | | task update <board_id> <task_id> [options] | タスク情報を更新する | | task delete <board_id> <task_id> | タスクを削除する | | task search <board_id> [query] | キーワードでタスクを全文検索する | | task move <task_id> <board_id> <list_id> | タスクを移動する | | task archive <board_id> <task_id> | タスクをアーカイブする |

| コマンド | 説明 | | --- | --- | | comment list <task_id> | コメント一覧を取得する | | comment get <task_id> <comment_id> | コメント情報を取得する | | comment create <task_id> <content> | コメントを追加する | | comment update <task_id> <comment_id> <content> | コメントを更新する |

ラベル

| コマンド | 説明 | | --- | --- | | label list <board_id> | ラベル一覧を取得する | | label create <board_id> <name> [color] | ラベルを追加する | | label update <board_id> <label_id> [options] | ラベル情報を更新する | | label delete <board_id> <label_id> | ラベルを削除する |

チェックリスト

| コマンド | 説明 | | --- | --- | | checklist list <task_id> | チェックリスト一覧を取得する | | checklist create <task_id> <title> | チェックリストを追加する | | checklist update <task_id> <checklist_id> <title> | チェックリスト情報を更新する | | checklist delete <task_id> <checklist_id> | チェックリストを削除する | | item list <checklist_id> | アイテム一覧を取得する | | item create <checklist_id> <content> | アイテムを追加する | | item update <checklist_id> <item_id> [options] | アイテム情報を更新する | | item delete <checklist_id> <item_id> | アイテムを削除する |

その他

| コマンド | 説明 | | --- | --- | | rate-limit | レート制限情報を取得する | | help [object] [action] | ヘルプを表示する | | version | バージョンを表示する |

---

開発者向け

必要なツール

Go 1.22 以上
GoReleaser（リリース時のみ）

Go のインストール

macOS:

brew install go

Linux:

curl -fsSL https://go.dev/dl/go1.22.0.linux-amd64.tar.gz | sudo tar -C /usr/local -xzf -
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

GoReleaser のインストール

macOS:

brew install goreleaser

Linux / その他:

go install github.com/goreleaser/goreleaser/v2@latest

ビルド

make build          # ./jooto バイナリを生成
make clean          # ビルド成果物を削除

ローカルビルド & インストール

ソースから直接ビルドしてインストールします。バージョンには日時と Git ハッシュが埋め込まれます。

./dev-install.sh                          # /usr/local/bin にインストール
INSTALL_DIR=~/.local/bin ./dev-install.sh # インストール先を変更

プロジェクト構成

main.go          # エントリポイント・コマンドルーティング
cmd/             # コマンドハンドラー
api/             # Jooto API クライアント
config/          # プロファイル・設定管理 (~/.config/jooto/config.toml)
install.sh       # リリース用インストールスクリプト
dev-install.sh   # 開発用ローカルインストールスクリプト

リリース

1. Git タグを作成してプッシュ:

git tag v0.2.0
git push origin v0.2.0

2. GoReleaser でリリース実行:

make release

これにより以下が自動で行われます:

各プラットフォーム向けクロスコンパイル（CGO 無効）
tar.gz アーカイブとチェックサムファイルの生成
GitHub Releases へのアップロード（install.sh 含む）
バージョン情報の埋め込み（-ldflags 経由）

リリースには環境変数 GITHUB_TOKEN が必要です。

ライセンス

Apache License 2.0

jooto

Summary

Install to Claude Code