設定パネル

zerocode の Config ペインは、稼働中の ZeroClaw を設定するための手段です。各設定項目には型付きのコントロール、検証機能、その機能を説明するインライン解説が用意されており、ほとんどの設定はデーモンを再起動せずにライブで適用されます。任意の zerocode セッションから開き、設定ファイルを手動で編集するのではなく、そこで設定を編集してください。

設定は引き続き構成ファイルに保存され、ドキュメントには該当するフィールドが説明されているため、特定のコントロールが何を書き込むかを正確に確認できます。これらの説明は保存された結果として読み、ファイルをエディターで開く指示としては読まないでください。手動編集は、ヘッドレスホストやスクリプトによるプロビジョニングのためのフォールバック手段であり、その場合はドキュメントで明示的に言及されています。

キーバインド修飾子

キーバインドでは正規の修飾キー名を使用します。control は Control キーそのものを表し、primary は macOS では Command、それ以外では Control を表し、super は Super/Command キーそのものを表します。たとえば、control+c、primary+r、alt+shift+up はプラットフォーム間で利用できる保存値です。古い ctrl+... の値は、設定の読み込み時に一度だけ移行され、対応する正規の表記に書き換えられます。

なぜファイルではなくペインなのか

検証。 コントロールは不正な値がデーモンに到達する前に拒否するため、入力ミスによって設定が読み込めない状態になることはありません。
発見しやすさ。 すべての設定にはインラインの説明が付いているため、フィールドの機能を知るために設定リファレンスを相互参照する必要はありません。
ライブ適用。 ほとんどの設定は次のフレームで反映され、再起動は不要です。
レジストリベースのリスト。 プロバイダー、チャンネル、モデル、テーマの選択肢はバックエンドのレジストリから取得されるため、表示されるオプションはこのビルドがサポートしているものと完全に一致します。

ローカル UI の設定 (`zerocode-config.toml`)

一部の設定はデーモンの動作ではなく、_zerocode 自体が_ペインをどのように描画するかを定義します。これらは zerocode の専用ファイル <config-dir>/zerocode-config.toml にあり、zerocode の Config ペインから編集します。

TodoWrite トラッカーはその一つです。これは表示専用の処理です。デーモンは計画の更新を発行するだけで、ACP 経由ではクライアントが書式設定を完全に制御するため、zerocode が所有します:

[todotracker]
enabled = true           # マスタースイッチ。false の場合、トラッカーは表示されない
enabled_at_start = false # 起動時に表示（最初のプランが到着する前）
location = "right"       # "bottom"、"left"、または "right"
width = 32               # サイドパネルの目標列幅（left/right）
max_height = 5           # ボトムストリップの最大高さ（行数）

値はセッション境界ごとに再読み込みされるため、Config ペインで行った編集は、次に開始、再起動、または切り替えを行うセッションに適用され、zerocode を再起動する必要はありません。

環境による上書き

すべてのフィールドは、ZEROCODE_ 変数を使用して、1回の実行に限り上書きできます。表記は、プレフィックスの後に小文字の設定パスを続け、. は __ として記述します:

ZEROCODE_todotracker__enabled=false zerocode
ZEROCODE_todotracker__location=下部 zerocode

これらのオーバーライドはプロセスの実行中にのみ有効で、実行中のインスタンスにのみ影響し、zerocode-config.toml に書き戻されることはありません。Config ペインで無関係なフィールドを保存しても、環境変数から注入された値がファイルに保存されることはありません。

デーモン所有の `[todotracker]` からアップグレードする

この設定が移動する前は、[todotracker] は デーモン の config.toml にあるセクションでした。そこに設定していた場合は、値を移行してください：

デーモンの config.toml を開き、[todotracker] の値を記録します。
同じブロックを、上記に示した <config-dir>/zerocode-config.toml に追加するか、設定 → Todoトラッカー から設定します。
デーモンの config.toml から [todotracker] セクションを削除します。

既存の ZEROCLAW_todotracker__* 環境変数は、アップグレード前に削除する必要はありません。認識される5つのフィールド（enabled、enabled_at_start、location、width、max_height）はデーモンによって受け付けられたうえで無視されるため、以前動作していたデプロイメントは引き続き起動します。これらはもはや何の効果も持たないため、上記の ZEROCODE_ 形式に移行してください。

Keyboard shortcuts

ZeroClaw Docs