Make `--max-autopilot-continues` persistable in settings and adjustable mid-session via /limits
まだ誰も着手していません。
- 主要言語
- Shell
- スター
- 11.2k
- フォーク
- 1.9k
- 平均マージ
- 14時間 16分
- マージ済み PR(30日)
- 6
説明
Describe the feature or problem you'd like to solve
--max-autopilot-continues (default 5) is the only control over how long autopilot keeps going, but it is launch-flag-only: there is no settings.json key, no environment variable, and no way to change it once a session has started. Long-running autopilot work therefore stops at 5 continuations unless you remember the flag at launch — and when it does stop, there is no way to raise it without restarting the CLI and losing the session.
Proposed solution
Two related changes, either of which is useful on its own:
1. A persistable setting (maxAutopilotContinues)
Add a settings.json / config.json key so the default can be set once, with --max-autopilot-continues still overriding it per-invocation.
Today the value is registered in the arg parser with a hardcoded default and read only from the parsed CLI options object:
new Option("--max-autopilot-continues <count>", "Maximum number of continuation messages in autopilot mode")
.default(5)
Confirmed absent from copilot help config (no settings key) and copilot help environment (no env var). The only workaround is shadowing the launcher with a shell wrapper that injects the flag:
function copilot {
$copilotArgs = @($args)
if (-not ($copilotArgs | Where-Object { $_ -like '--max-autopilot-continues*' })) {
$copilotArgs += @('--max-autopilot-continues', 50)
}
& $RealCopilotShim @copilotArgs
}
That works, but it is per-shell (breaks if you launch from a different shell), invisible to anyone reading their config, and easy to forget on a new machine.
This is the same "hardcoded constant → user-settable key" shape as #1688 (configurable auto-compaction threshold), and #3977 established the precedent of adding a settings.json key for autopilot behavior — that one shipped as stayInAutopilot, which persists the mode but not the continuation cap.
2. Runtime adjustment via /limits
Make the cap changeable mid-session, e.g. /limits set max-autopilot-continues <n>.
This is the more valuable half. The value is currently read once at session construction and threaded through to the continuation decision, so when autopilot halts at the limit the session is stuck — the only recovery is restarting and losing accumulated context.
/limits is already the natural home for this: it lets you raise max-ai-credits live, and the limit-reached message already tells you to "increase or unset the session limit before trying again." Hitting the autopilot cap should offer the same recovery, ideally with an inline prompt to extend when the limit is reached.
Example prompts or workflows
- Long refactor —
/plana large migration, choose "Accept plan and build on autopilot", walk away. It stops after 5 continuations with most todos stillpending; restarting to pass a flag discards the plan context. - Set once, forget — put
"maxAutopilotContinues": 50insettings.jsonalongsidestayInAutopilot, instead of maintaining a shell wrapper on every machine. - Recover in place — autopilot stops at the cap with 3 todos left; run
/limits set max-autopilot-continues 40and resume, rather than restarting. - Fleet runs —
/fleetorchestration dispatches subagents across many todos and legitimately needs more continuations than a single-file edit; today both share the same default of 5. - Cost control that actually fits — raise the continuation cap while relying on
--max-ai-creditsas the real spend guardrail, instead of using a low continuation count as a proxy for budget.
Additional context
- Copilot CLI 1.0.79, Windows 11, PowerShell 7
- Related: #1688 (configurable auto-compaction threshold — same shape), #3977 (closed; added
stayInAutopilot, adjacent but different knob), #4210 (configurable autopilot retry count), #3352 (/configeditor — would surface this key once it exists) - Precedent for this class of request shipping: #2520, #3026, #2582
- Note that raising the cap safely depends on
--max-ai-credits, which is itself already session-settable via/limits— so the two controls are currently inconsistent in how they can be adjusted.
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
--max-autopilot-continues の引数パーサー登録と、settings.json/config.json の読み込み経路から始めます。次に、/limits の処理と、値が autopilot の継続判定に到達するセッション構築経路を追跡します。設定に記載された優先順位があり、/limits でアクティブな上限を変更でき、ドキュメント化されたワークフローが CLI を再起動せずに動作すれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- shell
- 領域
- cli, tooling
- issue の種類
- 機能追加
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 活発さ
- 静か
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 52/100