composio-cli

Composio CLI

認証管理機能を備えた、1000 以上の SaaS ツールを利用するための統合ターミナルインターフェースです。信頼できる手順は常に、検出 → スキーマを確認 → 接続を確保 → 実行です。ツールのスラッグを決して推測せず、接続済みアカウントを確認せずに実行しないでください。

セットアップ

curl -fsSL https://composio.dev/install | bash   # install
composio --version
composio login                                   # browser auth
composio whoami                                   # confirm identity

composio が見つからない場合は、先にインストールしてください。whoami が失敗した場合、ユーザーは composio login を実行する必要があります（対話型の操作なので、ユーザー自身に実行するよう案内してください）。

実行手順

1. スラッグを検出する（決して推測しない）

composio search "send a slack message" --human
composio search "create issue" --toolkits github
composio tools list github            # all tools in a toolkit
composio tools info GITHUB_CREATE_AN_ISSUE

2. 呼び出す前にスキーマを確認する

composio execute GITHUB_CREATE_AN_ISSUE --get-schema

ユーザーの意図を必須フィールドに対応付けます。必須フィールドが不明な場合は質問し、捏造しないでください。

3. アカウントの接続を確保する

composio link github --list      # already connected?
composio link github             # connect if not (interactive)
composio connections list

未接続のツールキットに対するツール呼び出しは失敗します。先に確認してください。

4. ドライランしてから実行する

composio execute GITHUB_CREATE_AN_ISSUE --dry-run -d '{"owner":"acme","repo":"api","title":"Bug"}'
composio execute GITHUB_CREATE_AN_ISSUE -d '{"owner":"acme","repo":"api","title":"Bug"}'
composio execute SLUG -d @payload.json     # large payloads from file
composio execute SLUG --file ./image.png   # file upload
composio execute -p SLUG_A -d '...' SLUG_B -d '...'   # parallel

書き込みや破壊的な操作の場合は、先にドライランを行い、実際に呼び出す前にユーザーの確認を得てください。

その他のモード

必要な操作	コマンド
認証済み API の直接呼び出し	composio proxy <URL> --toolkit <tk> -X POST -d '{...}'
イベントの購読	composio triggers list <tk> → composio listen <TRIGGER_SLUG> --timeout 5m --max-events 5
複数ステップのスクリプト化されたワークフロー	composio run --file ./workflow.ts（--dry-run でプレビュー）
型付き SDK スタブ	composio generate ts --toolkits github gmail

品質基準

• スラッグはメモリではなく、search／tools list から取得します。
• スキーマを確認し、ペイロードを必須フィールドに正確に合わせます。
• 実行前に接続を確認します。
• 書き込み操作はドライランを行い、ユーザーの確認を得ます。
• 必須入力が不明な場合は質問し、捏造しません。

アンチパターン

• --get-schema を使わずに、ツールのスラッグやペイロードの形式を推測する。
• connections list を確認する前に execute する → 原因が分かりにくい認証エラーが発生します。
• 破壊的な呼び出しで --dry-run を省略する。
• シークレットをペイロードにハードコーディングする（認証は Composio が管理するため、トークンを渡さないでください）。
• composio login をスクリプトから実行できるものとして扱う。これは対話型の操作なので、ユーザーに実行してもらってください。