GitHub Copilot CLIのオプション一覧 (ver 1.0.10)

GitHub Copilot CLI のオプションが多すぎてわかりづらいので、整理してみました。索引のようなものとしてお使いください。
CLI のバージョンが上がれば記事も更新します。

確認したバージョン

copilot --version
GitHub Copilot CLI 1.0.10.
Run 'copilot update' to check for updates.

CLI のヘルプ

copilot -h
Usage: copilot [options] [command]

GitHub Copilot CLI - An AI-powered coding assistant.

Start an interactive session to chat with Copilot, or use -p/--prompt for
non-interactive scripting. Copilot can edit files, run shell commands, search
your codebase, and more — all with configurable permissions.

Run `copilot <command> --help` for details on any subcommand.

Options:
  --effort, --reasoning-effort <level>  Set the reasoning effort level (choices: "low", "medium", "high", "xhigh")
  --acp                                 Start as Agent Client Protocol server
  --add-dir <directory>                 Add a directory to the allowed list for file access (can be used multiple times)
  --add-github-mcp-tool <tool>          Add a tool to enable for the GitHub MCP server instead of the default CLI subset (can be used multiple times). Use "*" for all tools.
  --add-github-mcp-toolset <toolset>    Add a toolset to enable for the GitHub MCP server instead of the default CLI subset (can be used multiple times). Use "all" for all toolsets.
  --additional-mcp-config <json>        Additional MCP servers configuration as JSON string or file path (prefix with @) (can be used multiple times; augments config from ~/.copilot/mcp-config.json for this session)
  --agent <agent>                       Specify a custom agent to use
  --allow-all                           Enable all permissions (equivalent to --allow-all-tools --allow-all-paths --allow-all-urls)
  --allow-all-paths                     Disable file path verification and allow access to any path
  --allow-all-tools                     Allow all tools to run automatically without confirmation; required for non-interactive mode (env: COPILOT_ALLOW_ALL)
  --allow-all-urls                      Allow access to all URLs without confirmation
  --allow-tool[=tools...]               Tools the CLI has permission to use; will not prompt for permission
  --allow-url[=urls...]                 Allow access to specific URLs or domains
  --alt-screen[=value]                  Use the terminal alternate screen buffer (on|off)
  --autopilot                           Enable autopilot continuation in prompt mode
  --available-tools[=tools...]          Only these tools will be available to the model
  --banner                              Show the startup banner
  --bash-env[=value]                    Enable BASH_ENV support for bash shells (on|off)
  --config-dir <directory>              Set the configuration directory (default: ~/.copilot)
  --continue                            Resume the most recent session
  --deny-tool[=tools...]                Tools the CLI does not have permission to use; will not prompt for permission
  --deny-url[=urls...]                  Deny access to specific URLs or domains, takes precedence over --allow-url
  --disable-builtin-mcps                Disable all built-in MCP servers (currently: github-mcp-server)
  --disable-mcp-server <server-name>    Disable a specific MCP server (can be used multiple times)
  --disallow-temp-dir                   Prevent automatic access to the system temporary directory
  --enable-all-github-mcp-tools         Enable all GitHub MCP server tools instead of the default CLI subset. Overrides --add-github-mcp-toolset and --add-github-mcp-tool options.
  --excluded-tools[=tools...]           These tools will not be available to the model
  --experimental                        Enable experimental features
  -h, --help                            display help for command
  -i, --interactive <prompt>            Start interactive mode and automatically execute this prompt
  --log-dir <directory>                 Set log file directory (default: ~/.copilot/logs/)
  --log-level <level>                   Set the log level (choices: "none", "error", "warning", "info", "debug", "all", "default")
  --max-autopilot-continues <count>     Maximum number of continuation messages in autopilot mode (default: unlimited)
  --model <model>                       Set the AI model to use
  --mouse[=value]                       Enable mouse support in alt screen mode (on|off)
  --no-alt-screen                       Disable the terminal alternate screen buffer
  --no-ask-user                         Disable the ask_user tool (agent works autonomously without asking questions)
  --no-auto-update                      Disable downloading CLI update automatically (disabled by default in CI environments)
  --no-bash-env                         Disable BASH_ENV support for bash shells
  --no-color                            Disable all color output
  --no-custom-instructions              Disable loading of custom instructions from AGENTS.md and related files
  --no-experimental                     Disable experimental features
  --no-mouse                            Disable mouse support in alt screen mode
  --output-format <format>              Output format: 'text' (default) or 'json' (JSONL, one JSON object per line) (choices: "text", "json")
  -p, --prompt <text>                   Execute a prompt in non-interactive mode (exits after completion)
  --plain-diff                          Disable rich diff rendering (syntax highlighting via diff tool specified by git config)
  --plugin-dir <directory>              Load a plugin from a local directory (can be used multiple times)
  --resume[=sessionId]                  Resume from a previous session (optionally specify session ID or task ID)
  -s, --silent                          Output only the agent response (no stats), useful for scripting with -p
  --screen-reader                       Enable screen reader optimizations
  --secret-env-vars[=vars...]           Environment variable names whose values are stripped from shell and MCP server environments and redacted from output (e.g., --secret-env-vars=MY_KEY,OTHER_KEY)
  --share[=path]                        Share session to markdown file after completion in non-interactive mode (default: ./copilot-session-<id>.md)
  --share-gist                          Share session to a secret GitHub gist after completion in non-interactive mode
  --stream <mode>                       Enable or disable streaming mode (choices: "on", "off")
  -v, --version                         show version information
  --yolo                                Enable all permissions (equivalent to --allow-all-tools --allow-all-paths --allow-all-urls)

Commands:
  help [topic]                          Display help information
  init                                  Initialize Copilot instructions
  login [options]                       Authenticate with Copilot
  plugin                                Manage plugins
  update                                Download the latest version
  version                               Display version information

Help Topics:
  commands     Interactive Mode Commands
  config       Configuration Settings
  environment  Environment Variables
  logging      Logging
  permissions  Permissions

Examples:
  # Start interactive mode
  $ copilot

  # Start interactive mode and automatically execute a prompt
  $ copilot -i "Fix the bug in main.js"

  # Execute a prompt in non-interactive mode (exits after completion)
  $ copilot -p "Fix the bug in main.js" --allow-all-tools

  # Enable all permissions with a single flag
  $ copilot -p "Fix the bug in main.js" --allow-all
  $ copilot -p "Fix the bug in main.js" --yolo

  # Start with a specific model
  $ copilot --model gpt-5.2

  # Resume the most recent session
  $ copilot --continue

  # Resume a previous session using session picker
  $ copilot --resume

  # Resume a specific session by ID
  $ copilot --resume=<session-id>

  # Start a new session with a specific UUID
  $ copilot --resume=0cb916db-26aa-40f2-86b5-1ba81b225fd2

  # Resume with auto-approval
  $ copilot --allow-all-tools --resume

  # Allow access to additional directory
  $ copilot --add-dir /home/user/projects

  # Allow multiple directories
  $ copilot --add-dir ~/workspace --add-dir /tmp

  # Disable path verification (allow access to any path)
  $ copilot --allow-all-paths

  # Allow all git commands except git push
  $ copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

  # Allow all file editing
  $ copilot --allow-tool='write'

  # Allow all but one specific tool from MCP server with name "MyMCP"
  $ copilot --deny-tool='MyMCP(denied_tool)' --allow-tool='MyMCP'

  # Allow GitHub API access (defaults to HTTPS)
  $ copilot --allow-url=github.com

  # Deny access to specific domain over HTTPS
  $ copilot --deny-url=https://malicious-site.com
  $ copilot --deny-url=malicious-site.com

  # Allow all URLs without confirmation
  $ copilot --allow-all-urls

  # Initialize Copilot instructions for a repository
  $ copilot init

Learn More:
  Use `copilot <command> --help` for more information about a command.
  Read the documentation at https://docs.github.com/copilot/how-tos/copilot-cli

オプションの日本語訳

オプション	日本語訳（説明文）
--effort, --reasoning-effort <level>	推論の努力レベルを設定します（選択肢: "low", "medium", "high", "xhigh"）。
--acp	Agent Client Protocol サーバーとして起動します。
--add-dir <directory>	ファイルアクセスを許可するディレクトリを追加します（複数回指定可）。
--add-github-mcp-tool <tool>	既定の CLI サブセットの代わりに、GitHub MCP サーバーで有効にするツールを追加します（複数回指定可）。* ですべてのツールを指定できます。
--add-github-mcp-toolset <toolset>	既定の CLI サブセットの代わりに、GitHub MCP サーバーで有効にするツールセットを追加します（複数回指定可）。all ですべてのツールセットを指定できます。
--additional-mcp-config <json>	追加の MCP サーバー設定を JSON 文字列またはファイルパス（先頭に @ を付与）として指定します（複数回指定可。今回のセッションでは ~/.copilot/mcp-config.json の設定に追加されます）。
--agent <agent>	使用するカスタムエージェントを指定します。
--allow-all	すべての権限を有効にします（--allow-all-tools --allow-all-paths --allow-all-urls と同等）。
--allow-all-paths	ファイルパスの検証を無効にし、任意のパスへのアクセスを許可します。
--allow-all-tools	確認なしで全ツールの自動実行を許可します。非対話モードでは必須です（env: COPILOT_ALLOW_ALL）。
--allow-all-urls	確認なしですべての URL へのアクセスを許可します。
--allow-tool[=tools...]	CLI に使用を許可するツールを指定します。許可確認は表示されません。
--allow-url[=urls...]	特定の URL またはドメインへのアクセスを許可します。
--alt-screen[=value]	ターミナルの代替画面バッファを使用します（on|off）。
--autopilot	prompt モードで autopilot 継続を有効にします。
--available-tools[=tools...]	モデルに公開するツールをこれらのみに制限します。
--banner	起動時のバナーを表示します。
--bash-env[=value]	bash シェルで BASH_ENV のサポートを有効にします（on|off）。
--config-dir <directory>	設定ディレクトリを指定します（既定: ~/.copilot）。
--continue	最新のセッションを再開します。
--deny-tool[=tools...]	CLI に使用を許可しないツールを指定します。許可確認は表示されません。
--deny-url[=urls...]	特定の URL またはドメインへのアクセスを拒否します。--allow-url より優先されます。
--disable-builtin-mcps	すべての組み込み MCP サーバーを無効にします（現在: github-mcp-server）。
--disable-mcp-server <server-name>	特定の MCP サーバーを無効にします（複数回指定可）。
--disallow-temp-dir	システムの一時ディレクトリへの自動アクセスを禁止します。
--enable-all-github-mcp-tools	既定の CLI サブセットの代わりに、GitHub MCP サーバーの全ツールを有効にします。--add-github-mcp-toolset と --add-github-mcp-tool を上書きします。
--excluded-tools[=tools...]	モデルに利用させないツールを指定します。
--experimental	実験的機能を有効にします。
-h, --help	コマンドのヘルプを表示します。
-i, --interactive <prompt>	対話モードを開始し、指定したプロンプトを自動実行します。
--log-dir <directory>	ログファイルの保存先ディレクトリを指定します（既定: ~/.copilot/logs/）。
--log-level <level>	ログレベルを設定します（選択肢: "none", "error", "warning", "info", "debug", "all", "default"）。
--max-autopilot-continues <count>	autopilot モードでの継続メッセージの最大数を指定します（既定: 無制限）。
--model <model>	使用する AI モデルを設定します。
--mouse[=value]	alt screen モードでマウスサポートを有効にします（on|off）。
--no-alt-screen	ターミナルの代替画面バッファを無効にします。
--no-ask-user	ask_user ツールを無効にします（エージェントは質問せず自律的に動作します）。
--no-auto-update	CLI 更新の自動ダウンロードを無効にします（CI 環境では既定で無効）。
--no-bash-env	bash シェルでの BASH_ENV サポートを無効にします。
--no-color	すべてのカラー出力を無効にします。
--no-custom-instructions	AGENTS.md などのカスタム指示ファイルの読み込みを無効にします。
--no-experimental	実験的機能を無効にします。
--no-mouse	alt screen モードでのマウスサポートを無効にします。
--output-format <format>	出力形式を指定します。text（既定）または json（JSONL、1 行につき 1 つの JSON オブジェクト）を選べます（選択肢: "text", "json"）。
-p, --prompt <text>	非対話モードでプロンプトを実行します（完了後に終了します）。
--plain-diff	リッチな diff 表示を無効にします（構文強調は git config で指定された diff ツールを使用）。
--plugin-dir <directory>	ローカルディレクトリからプラグインを読み込みます（複数回指定可）。
--resume[=sessionId]	過去のセッションを再開します（セッション ID またはタスク ID を指定可能）。
-s, --silent	エージェント応答のみを出力します（統計情報は出しません）。-p と併用するとスクリプト用途に便利です。
--screen-reader	スクリーンリーダー向けの最適化を有効にします。
--secret-env-vars[=vars...]	値を shell や MCP サーバー環境から除去し、出力でもマスクする環境変数名を指定します（例: --secret-env-vars=MY_KEY,OTHER_KEY）。
--share[=path]	非対話モード完了後、セッションを markdown ファイルとして共有します（既定: ./copilot-session-<id>.md）。
--share-gist	非対話モード完了後、セッションを secret GitHub gist として共有します。
--stream <mode>	ストリーミングモードを有効/無効にします（選択肢: "on", "off"）。
-v, --version	バージョン情報を表示します。
--yolo	すべての権限を有効にします（--allow-all-tools --allow-all-paths --allow-all-urls と同等）。

公式ドキュメント

docs.github.com

プロンプト

この表も Copilot CLI に作ってもらいました。このときのプロンプトはこちら。 PowerShell で実行しています。

$copilotOptions = copilot -h
copilot --prompt "次の文字列はGitHub Copilot CLIのヘルプです。オプションの説明文を日本語に訳し、表形式で出力してください: $($copilotOptions)"