polylane-cli

Polylane CLI — エージェントスキルガイド

polylane は、エージェントが使いやすいコマンドで Polylane プラットフォームを操作します。トップレベルのコマンドは、エージェントが実際に実行するタスクに対応しています。API の全機能は、代替手段として polylane api から利用できます。

このファイルでは、コマンドの仕様とワークフローについて説明します。意図的にコマンド一覧は記載していません。ヘルプが正式な情報源です — インストール済みのバージョンが反映されます。

polylane --help                                  # resource list
polylane <resource> --help                       # verbs for a resource
polylane <resource> <verb> --help                # flags + examples for one command

ファーストクラスのコマンドに該当しない操作には、次を使用してください。

polylane api list [--tag <Tag>] [--query <q>]    # every operation
polylane api describe <operation-id>             # its shape
polylane api call <operation-id> [--body '{...}' | --body-file path]

概念、スキーマ、制限については、https://docs.polylane.com を参照してください（認証不要で、機械可読です。インデックスは /llms.txt にあります）。

前提条件

# Install the reviewed CLI version (Node.js 20 or later)
npm install -g @coreplane/[email protected]

# Auth — OAuth is the default; API key where a browser is impossible
polylane auth login                                    # OAuth browser (PKCE)
polylane auth login --no-browser                       # device code (SSH / headless)
polylane auth login --api-key sk_xxxxx                 # scripts / CI
polylane auth signup --email <email> [--password <pw>] # new account (emails a 6-digit code); omit --password to get a generated one, shown once
polylane auth signup --email <email> --code <code>     # finish verification non-interactively
polylane auth status                                   # verify

# Workspace — set once, then forget
polylane workspace use <workspace-id-or-slug>
polylane workspace create --name "My Workspace"        # new + makes default

API キーは ~/.polylane/config.json に保存されます。OAuth とサインアップのセッショントークンは ~/.polylane/credentials.json に保存され、自動で更新されます。サインアップ後に長期間エージェントからアクセスする場合は、API キーを作成し、polylane auth logout --yes && polylane auth login --api-key <key> で切り替えてください。グローバルの --api-key フラグと POLYLANE_API_KEY は、保存済みのセッショントークンより優先されますが、auth login --api-key で保存した設定ファイル内のキーは優先されません。サインアップ／ログイン後のアカウント管理は、ウェブコンソールで行います。

設定の優先順位：フラグ > 環境変数（POLYLANE_API_KEY、POLYLANE_WORKSPACE_ID、POLYLANE_OUTPUT、…）> ~/.polylane/config.json > デフォルト。環境変数の一覧については、https://docs.polylane.com/tools/cli/configuration を参照してください。テレメトリーは、polylane telemetry status / disable または DO_NOT_TRACK=1 で設定できます。

エージェント用フラグ

非対話型（エージェント／CI）環境では、次のフラグを組み合わせて使用します。

フラグ	用途
--non-interactive	プロンプトを表示する代わりに、引数が不足していればすぐに失敗します
--quiet	スピナーを抑制します — stdout はデータのみになります
--output json	TTY の状態にかかわらず JSON を強制します（stdout がパイプされている場合は、JSON がすでにデフォルトです）
--full	リストコマンドでの絞り込みを無効にします
--no-wait	thread ask / continue を実行して待機せずに戻ります
--yes	破壊的操作の確認プロンプトを省略します
--dry-run / --verbose	リクエストをプレビューします / HTTP トラフィックをログに記録します
--api-key / --workspace / --timeout	呼び出しごとに値を上書きします

仕様

stdout はデータのみです（JSON、テーブル行、ストリーミングトークン、URL — 安全にパイプできます）。進捗状況、ヒント、エラーは stderr に出力されます。エラーは Error: <message> + Hint: <how to fix it, often the exact command> として出力されます。JSON モードでは、{"error": {"code", "message", "hint"}} が stderr に出力されます。code は終了コードで、ヒントがない場合は hint が省略されます。

終了コード（安定しているため、$? の値に応じた分岐に使えます）：0 成功 · 1 一般エラー · 2 使用方法のエラー · 3 認証エラー · 4 レート制限／プラン制限 · 5 タイムアウト · 6 ネットワークエラー · 7 処理中（AWS スタックの作成中、またはプランのアップグレード処理中） · 130 中断。

API オブジェクトには _html_url（コンソールの詳細リンク）と _links（次の操作）が含まれます。単一オブジェクトでは Console: / Next: フッターとして表示され、JSON モードではそのまま保持されます。

主なワークフロー

問題を調査する

polylane issue list --active                      # what's currently flagged
polylane issue show <issue-id>                    # full body + linked investigation
polylane feed list --category change --since 24h  # what changed recently
polylane service find "<query>"                   # locate the service
polylane service logs <service-id> --since 1h --grep error
polylane service metrics <service-id> --since 1h
polylane service graph <service-id> --direction both --depth 1
polylane repo grep <owner/repo> "<pattern>"       # correlate with code
polylane issue note <issue-id> "<what you did>"   # record as you go
polylane memory save "<confirmed finding>"        # teach future runs

オンボーディング

polylane integration catalog                      # discover what can connect
polylane integration connect --type <type>        # per-type flags: see --help
polylane cloud connect --provider <provider>      # per-provider flags: see --help
polylane integration list && polylane cloud list && polylane service list   # verify

エージェントツールを直接実行する

Polylane 自身のエージェントが使うツールを、スレッドを開かずに利用できます — 接続済みのすべてのプロバイダーを対象にしたテレメトリークエリ、グラフのトラバーサル、コード検索などです。

polylane tools search "<capability>" [--full]      # discover (+ JSON schemas)
polylane tools run <name> --params '{...}'
polylane tools code 'async () => { return await tools.findNodes({ query: "api" }); }'

デフォルトでは読み取り専用です。書き込みには、agent_tools:write スコープを持つ認証情報と --write が必要です。

エージェントと対話する

polylane thread ask "<prompt>" [--context <ids>]   # blocking, streams the reply to stdout in text mode; ids typed by prefix (repo_, acc_, thrd_, mem_; anything else is a resource node)
TID=$(polylane thread ask "<prompt>" --no-wait --output json --quiet | jq -r '.id')
polylane thread continue "$TID" "<follow-up>"

コーディングエージェントを設定する

polylane setup [--agent claude|cursor|opencode|codex|…] [--project] は、検出された各エージェント（または指定されたエージェント）の設定に MCP サーバー（https://mcp.polylane.com/mcp）を登録します。また、スキルを読み込むエージェント（claude、cursor、opencode、codex、pi、warp）には、このスキルを skills/polylane-cli/SKILL.md としてインストールします。繰り返し実行しても安全です。

ヘルプテキストには書かれていない注意点

• ブラウザーフローによる接続（OAuth 方式のプロバイダーでは integration connect、cloud connect）では、URL が stdout に出力されます。その後、対話型ターミナルでは接続が確認されるまでポーリングします（約 5 分、AWS は 15 分）。タイムアウトすると終了コード 1 で終了し、Ctrl+C を押すと終了コード 0 で終了しますが、ブラウザーでのセットアップは続行されます。--output json、--non-interactive、--dry-run を指定した場合、または TTY がない場合は、URL が出力されるとすぐに終了コード 0 で終了します。いずれの場合も、list／show を再実行して確認してください。
• 一部の処理が成功した場合でも終了コードは 0 です：接続形式の操作では { accounts: [...], failures: [...] } が返されることがあります。failures を確認してください。
• --since の意味は 2 通りあります：service logs／service metrics／feed では期間文字列（1h、7d）ですが、issue list では Unix ミリ秒です（--from／--to もすべて同様です）。
• 破壊的なコマンドの非対話型での動作には一貫性がありません：cloud disconnect／integration disconnect は --yes がないと終了コード 2 で終了しますが、memory delete、note delete、artifact delete、auth logout は確認せずに続行します。確認をキャンセルすると、stderr に Cancelled. Nothing changed. と出力され、終了コード 0 で終了します。
• 既存ユーザーとパスワードが一致する場合、auth signup はべき等です。セッションの更新のために安全に再実行できます。
• thread ask／continue の待機時間は最大 10 分です：タイムアウトしても終了コード 0 で終了します（JSON の status: "pending"）。polylane thread show <id> で状況を確認してください。--stream は非推奨で、何も実行しません。