設定パネル
zerocode の Config ペインは、実行中の ZeroClaw を設定します。各設定には型付きのコントロール、バリデーション、インラインの説明があります。保存が成功すると変更は永続化されますが、実行中のコンポーネントへの適用は設定と対象によって異なります。設定を編集するには、任意の zerocode セッションから Config を開いてください。
設定は引き続き構成ファイルに保存され、ドキュメントには該当するフィールドが説明されているため、特定のコントロールが何を書き込むかを正確に確認できます。これらの説明は保存された結果として読み、ファイルをエディターで開く指示としては読まないでください。手動編集は、ヘッドレスホストやスクリプトによるプロビジョニングのためのフォールバック手段であり、その場合はドキュメントで明示的に言及されています。
キーバインド修飾子
キーバインドでは正規の修飾キー名を使用します。control は Control キーそのものを表し、primary は macOS では Command、それ以外では Control を表し、super は Super/Command キーそのものを表します。たとえば、control+c、primary+r、alt+shift+up はプラットフォーム間で利用できる保存値です。古い ctrl+... の値は、設定の読み込み時に一度だけ移行され、対応する正規の表記に書き換えられます。
なぜファイルではなくペインなのか
- 検証。 コントロールは不正な値がデーモンに到達する前に拒否するため、入力ミスによって設定が読み込めない状態になることはありません。
- 発見しやすさ。 すべての設定にはインラインの説明が付いているため、フィールドの機能を知るために設定リファレンスを相互参照する必要はありません。
- アプリケーションからのフィードバック。 保存された変更は、デーモンが対応している場合、影響を受けた実行中のターゲットに対するアプリケーションの応答結果として表示されます。その他の設定には明示的な再読み込みが必要です。
- レジストリベースのリスト。 プロバイダー、チャンネル、モデル、テーマの選択肢はバックエンドのレジストリから取得されるため、表示されるオプションはこのビルドがサポートしているものと完全に一致します。
Saved and applied changes 変更を保存して適用しました
daemon の Config 編集が成功すると、アプリケーションの概要では、保存されたプロパティとそのリビジョンが、実行中のターゲットの結果とは分けて表示されます。エディタや検索フィールドの外で s を押すと、application status を開きます。スクロールには Up/Down または Page Up/Page Down を、戻るには Escape を使用します。設定された application_status アクションで、デフォルトのショートカットを置き換えることができます。
各結果には、正規化されたパスの構成要素、そのリビジョン、そして記述対象のデーモンまたはセッションのインスタンスが表示されます。セッションでは同じ変更について Applied live と表示される一方で、デーモンでは Reload required と表示されることがあります。Pending は対象がまだ更新を確認応答していないことを、Rejected は試行先の対象が更新を受け入れなかったことを意味します。スキーマが対応していることや保存が成功したことだけでは、適用されたとはみなせません。
Receipt が見つからない、status API がサポートされていない、読み取りに失敗した、daemon の epoch が置き換えられた、または結果が見つからない場合は、Application status unavailable と表示されます。daemon が保持するのは、観測された変更の上限付きの集合であり、完全な一覧や永続的な履歴ではありません。切り詰めや記録の欠落が成功を意味することはありません。無関係な古い編集の結果は、実際の revision を保持します。別の書き手による後の編集の結果では、自分の保存を確認することはできません。個別のライフサイクルメソッドを経由する alias 操作には save receipt がない場合があり、正確な保存フィードバックについては利用できないままです。
Config を表示している間、アプリケーションの状態は更新されます。Config から離れる、または接続が切れると、そのキャッシュされたアプリケーションビューは無効になります。再読み込みは既存の明示的な再読み込みアクションと確認を通じて継続され、状態の読み取りでは再読み込みは発生しません。ローカルの ZeroCode 設定、personality ファイル、skill ファイルは、デーモンの設定適用台帳を共有しないため、それぞれ独自の保存フィードバックを維持します。
ローカル 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 # ボトムストリップの最大高さ（行数）
シェルレベルのエージェントサイドバーも同じファイルに保存されます。デフォルトのセクションは明示的にシリアライズされるため、環境変数による上書きの対象となるスキーマノードが存在します:
[sidebar]
visible = true # show the agent/session sidebar at launch
width = 24 # target width in terminal columns
Ctrl+B を押すと、サイドバーの表示と非表示を切り替えます。クイックスタートは、キーボードモードバーからキーボード操作で引き続き利用でき、サイドバーのランチャーとしても表示されます。狭いターミナル幅でも同様です。サイドバーから既存のエージェントを選択すると、そのペインで既に追跡されている他のセッションを置き換えることなく、新しい Chat または Code セッションが開始されます。
TodoWrite の値はセッションの境界ごとに再読み込みされるため、Config ペインで行った編集は、次に開始・再起動・切り替えるセッションに適用されます。zerocode の再起動は不要です。
環境による上書き
すべてのフィールドは、ZEROCODE_ 変数を使用して、1回の実行に限り上書きできます。表記は、プレフィックスの後に小文字の設定パスを続け、. は __ として記述します:
ZEROCODE_todotracker__enabled=false zerocode
ZEROCODE_todotracker__location=下部 zerocode
ZEROCODE_sidebar__visible=false 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_ 形式に移行してください。