ドキュメント · 設定

設定

変更できる項目はすべて Settings（設定、s）にあります。キー、o が開くエディター、テーマ、そのほかの行です。変更は Settings を離れるときに保存され、その時点で反映されます。書き込まれるのは変更した行だけなので、その間に別のマネージャーや CLI が加えた変更は残ります。各 CLI の起動コマンド、再開と分岐のコマンド、MCP の登録、ステータスのルールはバイナリに含まれているので、アップグレードすればそのすべてが最新になります。

マネージャーは各設定を、OS のユーザー設定ディレクトリにある SQLite ファイル state.db に保存します。

editor の行で、o がディレクトリを開くコマンドを選びます。←→ で auto、PATH 上で見つかった各 GUI エディター、$VISUAL と $EDITOR が指すエディター、そして custom を順に切り替えます。custom では ↵ で独自のコマンドを入力する欄が開きます。auto は $AGENT_MANAGER_EDITOR、次に PATH 上の GUI エディター、次に $VISUAL / $EDITOR の順に解決されます。Linux では、$BROWSER を設定していればリンクはそれで開きます（コロン区切りで、URL は %s）。設定がなければ xdg-open を使います。macOS ではリンクを open に渡します。ペインはステータス、プレビュー、統計のために 2 秒ごとにポーリングされます。

シェルからの設定#

agent-manager settings を使うと、マネージャーを開かずに同じ設定を読み書きできます。settings list はすべてのキーを、その値と取りうる値とともに表示します。settings get は 1 つを表示し（保存されていなければデフォルト値）、settings set は 1 つを書き込みます。そのキーの選択肢にない値は拒否され、拒否のメッセージに選択肢が示されます。

agent-manager settings set theme "tokyo night"
agent-manager settings set notifications off
agent-manager settings get list_density

実行中のマネージャーは notifications、coordination、notify_command をすぐに反映します。それ以外は次に Settings を開いたときに表示され、それ以降に適用されます。notify_command には Settings の行がありません。詳しくはステータスを参照してください。

保存済みプロンプト#

Settings の saved prompts の行には、繰り返し使う名前付きの指示を保存できます。n で作成、enter で編集、d で削除します。tab で名前と本文の間を移動し、ctrl+s で保存、esc で戻ります。名前は一意で、60 文字まで、角かっこは使えません。本文は 64 KiB までです。1 つの一覧を n フォーム、クイックプロンプトモード、フォーカス中のセッション、spawn --saved、send --saved、そして create_session と send_session の saved で共有します。それぞれがどこに入るかはクイックプロンプトにあります。

agent-manager prompts list
agent-manager prompts add reviewer "Review the parser changes"
agent-manager prompts rm reviewer

保存済みプロンプトを変更や削除しても、すでに始まったセッションには影響しません。

config.toml からのアップグレード#

v0.40.0 より前のリリースは、このディレクトリの config.toml を読み込んでいました。アップグレード後の初回起動で、その editor の行と [keybindings.session]、[keybindings.list] の表が Settings に引き継がれるので、移動したキーはすべてそのままです。これは 1 回だけ行われます。それ以降、マネージャーが読むのは Settings だけになり、ファイルは削除してかまいません。マネージャーが読めないファイルは、理由とともに Messages（M）に表示され、キーはデフォルトから始まります。

ポーリングの間隔は 2 秒に固定されているので、このファイルの poll_interval の行は効果がありません。[tools.<name>] ブロックも同様です。各 CLI のコマンドとステータスのルールはバイナリに組み込まれているからです。

CLI#

Claude Code、OpenCode、Codex、Grok Build、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi、Cursor CLI が組み込まれており、さらに T が開くシェルもあります。それぞれの起動コマンド、復帰と分岐のコマンド、MCP の登録、ステータスのルール、そしてセッションのモデル、推論の強さ、プロファイルを指定して起動するためのフラグは、バイナリに含まれています。Hermes、Antigravity、Oh My Pi、Cursor CLI には分岐がなく、Pi と Oh My Pi には MCP の登録がありません。Settings（s）の CLIs の行で、n フォームとクイックプロンプトモードにどれを表示するかを選びます。最後の項目 request CLI support は、一覧にない CLI 用に下書き済みの issue を開きます。それぞれが何に対応しているかは対応エージェントにあります。

Agent Manager は各 CLI の最新リリースに対応しています。CLI によっては、まだ動作する最も古いリリースも指定されています。手元のバージョンがそれより古いと、起動、復帰、モデル一覧の表示のときにダイアログが開き、あなたのバージョン、必要なバージョン、アップデート用のベンダーのインストーラーが示されます。i でそのインストーラーを実行し、c でコピーします。/nix/store にある CLI にはインストーラーが示されず、インストールしたときと同じ方法でアップデートするようダイアログに表示されます。Pi は 0.84.3 以降が必要です。ほかの CLI にはまだ下限がありません。

ステータスの表示がおかしいとき#

ルールの修正は私たちが全員のために行います。SESSION_ID をセッション ID に置き換えて、ポーラーと同じ方法でペインを読み取り、そのテキストと CLI のバージョンを添えて issue を作成してください。

tmux -L agentmgr capture-pane -p -t am_SESSION_ID

キーバインド#

Settings の keybindings の行を選ぶと、2 つの表を持つピッカーが開きます。マネージャーがセッションの中で受け取るキーと、マネージャー自身のリストのキーです。各アクションには 1 つまたは複数のキーを割り当てられ、アクションをオフにすることもできます。1 つの表の中では、1 つのキーは 1 つのアクションにしか使えません。

↵ は次に押したキーを割り当て、a はアクションに 2 つ目のキーを追加し、d はアクションをオフにします。r は何が変わるかを示して確認したうえで、すべてのアクションを出荷時のキーに戻します。その表で使えないキーは、理由とともに拒否されます。ピッカーを離れると、変更した表がそれぞれ保存され、キーはすぐに有効になります。保存されるのは移動したキーだけなので、出荷時のデフォルトのままのアクションは、リリースでデフォルトが変われば新しいデフォルトに従います。

セッションのアクションは detach（デフォルトは ctrl+q と ctrl+\）、review（デフォルトは ctrl+r）、editor（デフォルトは f3）、saved_prompt（デフォルトは f4）、tmux_prefix（デフォルトはオフ）です。セッションのキーは ctrl+ と英字、alt+ と英字か数字、または f1 から f12 のいずれかです。単独の文字ではエージェントがそのキーを使えなくなるからです。detach には常に少なくとも 1 つのキーが残ります。tmux_prefix は管理対象のセッションに専用の tmux プレフィックス（1 キーまたは 2 キー）を与えるので、自分の tmux.conf でプレフィックスにしているキーを、たとえば detach のようなセッションのキーとして使えるようになります。

リストのアクションは up、down、open、attach、step_in、step_out、reorder_up、reorder_down、new_session、terminal、new_group、fork、prompt、copy_reply、review、mark_idle、rename、move、editor、restart、kill、kill_all、revive、revive_all、archive、cancel_end、restore、delete、search、filter、archived、empty_groups、fold_all、resize、settings、messages、help、quit、new_connection です。リストのキーは、単独の文字、space や pgup のようなキー名、shift+ と矢印または tab、あるいは上記の修飾キーの形です。esc と ctrl+c は変更できません。esc はどこでも取り消しです。ctrl+c は quit をオフにしてもマネージャーを終了し、フォーカス中のセッションではエージェントに送られます。settings には少なくとも 1 つのキーが残ります。

フルスクリーンのアタッチとフォーカスモードも同じ表に従い、agent-manager CLI から作成したセッションや、MCP サーバー経由でエージェントが作成したセッションにも適用されます。フッター、? のキーマップ、セッションのフッターはすべてこの表を読むので、移動したキーは移動先の名前で表示されます。

テーマ#

s で設定を開き、↑↓ またはホイールで項目の間を移動し、←→ でフォーカス中の項目を変更します。行をクリックするとその行に移動し、もう一度クリックすると値を変えるか実行します。save and close はほかと同じフッターのキーです。esc で実行され、独自のアクションを持たない行では enter でも実行され、クリックでも実行されます。パレットは 18 種類あります。ダークは 11 種類で、classic、solarized dark、catppuccin mocha、tokyo night、gruvbox dark、nord、dracula、rosé pine、monochrome、kanagawa wave、onedark です。ライトは 7 種類で、solarized light、catppuccin latte、tokyo night day、gruvbox light、rosé pine dawn、paper、kanagawa lotus です。

名前の横の色見本でパレットをプレビューでき、ピッカーで切り替えるたびにテーマが適用されるので、UI 全体のライブプレビューになります。マネージャーはターミナル自体の文字色と背景色もパレットに合わせるので、ウィンドウとの間に継ぎ目が出ず、終了時には元に戻します。エージェントのペインはテーマの背景色と文字色で描画され、ペインは中のエージェントにその両方を伝えるので、パレットを自動検出するエージェントもマネージャーと同じ明暗になります。

theme follows OS は、起動時に環境のライト / ダークの設定からパレットを決めます。macOS と Linux のデスクトップでは OS の設定、それ以外（SSH を含む）ではターミナル自体の背景色を使います。検出された側にすでに合っているテーマはそのままで、合わないときだけ切り替わります。ライトとダークの両方があるパレットはもう一方に切り替わり、catppuccin mocha は latte に、またその逆に変わります。それ以外のパレットは classic か solarized light に切り替わります。手動で選んだテーマは別に保存されているので、切り替えをオフにすると元に戻ります。

background は UI の背後のセルを何で塗るかを選びます。デフォルトの theme はパレットの色で塗るので、色の変更要求を無視するターミナルでも色が保たれます。terminal はターミナル自体の色のままにするので、半透明やぼかしのあるウィンドウ向けです。

シンボル#

symbols は、デフォルトの Advanced と、幾何学的な記号を描けないフォント向けのプレーンな ASCII の記号を使う Compatible を切り替えます。Compatible の対象は、ステータスの記号、ローダー、受信箱、ドラッグハンドル、グループの折りたたみ、ターミナルの行、worktree と分岐の記号、プロンプトと返信の接頭辞、検索、ダイアログのタイトル、お知らせ、保留中のアーカイブと終了、diff の結果です。行を切り替えると記号がプレビューされ、選択はすぐに適用されます。フォントは検出されません。枠線、ゲージ、矢印、キーのヒント、エージェントの出力はそのままです。両方の記号の一覧はステータスにあります。

図 5s · 設定

右から左に書くテキスト#

ヘブライ語やアラビア語の行は、占めるセルのとおりに描画され、どのホストでも同じです。iTerm2 の右から左への表示サポートや WezTerm の bidi_enabled のように、独自の双方向レイアウトを行うターミナルは、その行を自分で並べ替えます。Agent Manager が描画する列のとおりに表示を読むには、そのサポートをオフにしてください。

状態#

設定、並び順、グループ、アーカイブ、セッションのレイアウト、分割の比率は state.db に保存され、次回の起動時に復元されます。