Copilot CLI

一言で

主要機能

ターミナル一枚に、フルスタックの AI 環境が乗る。

• 複数ファイルの文脈把握：リポジトリ全体を一つのワークスペースとして扱う。
• コード生成・編集：ターミナルから修正し、差分を確認して承認できる。
• コマンド実行：ビルド・テスト・lint などを実行し、結果を読んで次に進む。
• IDE を選ばない：VS Code、Vim、SSH 先など、ターミナルがあれば使える。
• Skills / MCP 対応：必要な能力や外部ツールを追加できる。
• 非対話実行：CI、cron、script から copilot -p "..." で実行できる。

CLI と VS Code Chat の違い

強力なビルトインエージェント

Copilot CLI には、よくあるタスク向けのビルトインエージェントが用意されている。

💡 これらのビルトインエージェントの定義は、ローカルにインストールされた CLI の definitions/*.agent.yaml で確認できる（例: ~/.copilot/pkg/darwin-arm64/<version>/definitions/*.agent.yaml）。

Rubber Duck — クロスモデルレビュー

🦆 Experimental：メインモデルとは 異なるモデルファミリー が「セカンドオピニオン」として、計画・実装・テストの各段階で独立レビュー。

flowchart LR
  User([👤 開発者])
  Main["🧠 Main Model<br/>例: Claude"]
  Out["📝 計画 / 実装 / テスト"]
  Duck["🦆 Rubber Duck<br/>例: GPT-5.4"]
  Final([✅ 検証済み出力])
  User --> Main
  Main --> Out
  Out -->|"独立レビュー"| Duck
  Duck -->|"盲点 / 前提誤り"| Main
  Main --> Final

  classDef user fill:#0a1a14,stroke:#9bbc0f,color:#9bbc0f,stroke-width:2px
  classDef main fill:#0a0e27,stroke:#00f0ff,color:#00f0ff,stroke-width:2px
  classDef duck fill:#1a1500,stroke:#ffb000,color:#ffb000,stroke-width:2px
  classDef out fill:#1a0a2e,stroke:#ff2e88,color:#ff2e88,stroke-width:2px
  class User,Final user
  class Main main
  class Duck duck
  class Out out

なぜ効く？ ── 同じモデルが自分の出力をチェックすると、同じ前提・同じ盲点 に引っかかる。別ファミリーのモデルなら、訓練データも価値観も違うので 見えていなかったロジックエラー を拾える。

その他の便利コマンド

CLI は slash command で、モデル・共有・実験機能・環境情報などをすぐ確認できる。

🖥️ TUI(ターミナル UI)

/experimental on で、再設計されたターミナル UI を試せる。テーマ対応のセマンティックカラーを備え、/theme で確認できる。GitHub リポジトリ内では Tab キーで下の表のメニューを行き来できる。

📝 スクリーンリーダー対応をはじめ、ほかにも多くの UI 改善が入っている。詳しくは changelog ↗。

🛡️ Sandbox — 安全な実行環境

Copilot が動かすシェルコマンドを 隔離環境 で実行し、filesystem / network / system への到達を制限。agentic な作業を安心して任せられる。(Public Preview)

• 🔒 隔離対象:Copilot 起点のシェル実行の filesystem / network / system capability。
• 🔁 クラウドは状態を保持:Active → Stopped(snapshot)→ Deleted。別デバイスから再開でき、重い処理を並列実行できる。
• 🧩 認証はそのまま:Copilot CLI のサインインを使うので、別途クラウド設定は不要。

非対話モード(プログラマティック実行)★

Copilot CLI は copilot -p "..." で 1 コマンド実行 できる。対話セッションを開かず、1 ターンで完了して exit するので、シェルスクリプト・cron・バッチファイル・GitHub Actions から呼び出せる。定型業務の自動化や PR の自動レビューなど「人がやらなくていい作業」を Copilot に任せられる。

主要フラグ

• -p "..." / --prompt "..." — プロンプトを渡して 1 ターンで終了
• -s (silent) — メタデータを抑制し応答テキストのみを stdout に出力(変数代入・パイプ向け)
• --no-ask-user — clarifying question を出さず自律的に判断
• --allow-tool='shell(npm:*), write' — 必要なツールだけ許可(--allow-all はサンドボックスのみ)
• --model gpt-5.5 — モデルを固定して結果のブレを抑える
• --share='./session.md' — セッション全体を Markdown で保存

よくあるユースケース

• 📝 コミットメッセージの自動生成 / 📰 リリースノート作成
• 🐛 ESLint エラーの一括修正 / 🧪 テスト未整備モジュールにテスト追加
• 🔍 PR の AI レビュー(/review をスクリプト化) / 🔐 依存ライブラリの脆弱性監査
• 📚 README・JSDoc の一括生成 / 🌏 ドキュメントの自動翻訳

運用のコツ

• 🔑 認証は環境変数で渡す:COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN
• 🧾 PAT は fine-grained (v2) で「Copilot Requests」権限を付ける(古い ghp_ 形式は不可)
• 🛡️ --allow-tool でホワイトリスト指定が鉄則。--allow-all は使わない
• 🎯 プロンプトは具体的に — 出力フォーマット(「Number only.」「YES/NO」)も指定するとパースしやすい
• 📊 --share でセッションログを残しておくと、結果の根拠を後で追える
• 🧩 まず interactive で動かしてプロンプトを煮詰め、固まったら -p でスクリプト化が一番早い

📘 詳細:

• Running GitHub Copilot CLI programmatically ↗
• Programmatic reference (full flag list) ↗
• Automating tasks with Copilot CLI and GitHub Actions ↗