ヘッダーをカスタマイズする
よく使う操作が「ターミナルに打ち込む」しかないと、1 日に何十回も同じ文字を打つことになります。 MulmoTerminal は、稼働中セッションのヘッダーに自分のボタンを足せます。設定ファイルに数行 書くだけで、/compact の送信も、テストの実行も、社内 wiki を開くのも、ワンクリックになります。
このページは最初の 1 個を足すところから順に説明します。全フィールドの一覧は 設定 → ヘッダーのカスタマイズに。
1. まずヘッダーを読む
何も設定していないセルのヘッダーです。2 段あります。

| 場所 | 何が出ているか | 設定でどうなるか |
|---|---|---|
| 1 段目 左 | 状態ドット、⎇ main などの情報チップ | chips で並べ替え・非表示・追加 |
| 1 段目 右 | 履歴と道具のメニュー・寝かせる・拡大・閉じるなどセルの操作 | 変えられません(アプリの構造) |
| 2 段目 左 | ~/acme-api ▾ — パスメニュー(後述) | 変えられません |
| 2 段目 右 | Skill ドロップダウンとアイコンのボタン列 | buttons がここに入ります |
カスタマイズできるのは、この 2 段目の右側です。自分のボタンは Skill(稲妻のアイコン)の右に 並びます。既定でそこにあるアイコンはアプリ側の固定ボタンです。
既定のボタンは 1 つだけです — Open this branch’s PR(そのブランチに開いている PR が あるときだけ出ます)。以前ここにあった「ファイルのパスを挿入」「ファイルマネージャで開く」 「アプリでファイルを見る」「ここで新しいターミナル」と GitHub のリンクは、下のパスメニューへ移りました。
パスメニュー — ディレクトリに対する操作はここ
2 段目の左にあるパス(~/acme-api ▾)はボタンです。押すと、そのセルのディレクトリに対する 操作が出ます。

ファイルのパスを挿入(OS のダイアログで選んだファイルの絶対パスをプロンプトに入れる)・ ファイルマネージャで開く・アプリでファイルを見る・ここで新しいターミナル が、画面の言語で並びます。 リモートが GitHub のリポジトリなら、その下に GitHub の欄があり Repository / Issues / Pull requests / Actions が並びます。GitLab(gitlab.com、または gitlabHosts に書いたホスト)なら GitLab の欄に Repository / Issues / Merge requests / Pipelines が並びます。こちらはそのサービス自身の呼び名のままです。ここは固定なので設定では変わりません。同じことをボタンでも やりたい場合は、buttons に自分で書けば両方出ます。
2. 最初のボタンを 1 個足す
JSON を書かずに: 設定 → ヘッダーのボタンとチップ で、すべての端末にボタンを足せます。新しいセルでコマンドを実行する、エージェントに文字を入力する、何かを開く(URL・フォルダ・アプリの画面・このブランチの PR・ファイル選択)、アプリの名前付きの操作を実行する、の 4 種類で、アイコンと出す条件も付けられます。今あるボタンは、行の鉛筆で中身を直せ(id と位置はそのまま)、削除と並べ替えもできます。行のフォルダのアイコンで、そのボタンを既存のフォルダか、その場で名前を付けた新しいフォルダに入れられます。フォルダの中のボタンはその下に並び、外に出すとフォルダのすぐ後ろに置かれます(最後の 1 つを出すとフォルダは消えます)。それ以外は下のように書きます。
どのファイルに書くか
| ファイル | 効く範囲 |
|---|---|
~/.mulmoterminal/config.json | すべてのターミナル |
<プロジェクト>/.mulmoterminal.json | そのディレクトリで開いたセルだけ |
ボタンが出るのはエージェントのセル(Claude / Codex / Antigravity / Grok / Muse)です。ランチャーの チップや Shell セル、Run コマンドで開いたターミナルには出ません —— あれはユーザー自身のコマンドラインで、 このアプリが設定したものは何も足さないからです。
まずはプロジェクト側で試すのが安全です。プロジェクトのルートに .mulmoterminal.json を作って、 こう書きます。
{
"buttons": [
{
"id": "compact",
"icon": "compress",
"label": "Compact this conversation",
"run": "input",
"text": "/compact"
}
]
}
サーバの再起動は要りません。 ヘッダーは、作業ディレクトリ・セッション・エージェントが 変わったときと、ブラウザのウィンドウに戻ってきたときに読み直されます。エディタで保存して ブラウザに切り替えれば、それで反映されます。
押すと何が起きるか
run: "input" なので、そのセルで動いている Claude / Codex に /compact と打ち込んで送信します。 自分でターミナルに切り替えて打つのと同じことが、1 クリックで済みます。
大事な落とし穴 — buttons を書くと既定は消えます
buttons をどこかに 1 つでも書くと、組み込みの既定セットは丸ごと置き換わります(足されません)。 上の例だけを書くと、Open this branch’s PR が消えます。残したいなら自分で並べてください。
{
"buttons": [
{ "id": "pr", "icon": "github:git-pull-request", "label": "Open this branch's PR", "run": "open", "when": "isGitRepo", "open": { "pr": true } },
{ "id": "compact", "icon": "compress", "label": "Compact this conversation", "run": "input", "text": "/compact" }
]
}
3. アイコンとツールチップ
ここが最初につまずくところです。
label は画面に出ません。 ボタンが描くのはアイコンだけで、label は マウスを乗せたときに出るツールチップ(ブラウザ標準のもの)になります。
つまり label は「そのボタンが何なのか」を伝える唯一の手段です。Build のような単語より、 Run the tests のように動作が分かる文にしてください。ホバーするまで読めないのですから。
| キー | 役割 |
|---|---|
icon | Material Symbols の名前(compress、science、menu_book …)、または GitHub のアイコン(github:repo、github:issue-opened、github:git-pull-request、github:play、GitHub のロゴの github:mark-github)。画面に出るのはこれだけ |
emoji | 絵文字を 1 つ。icon より優先されます |
label | 必須。ホバーで出るツールチップ。読み上げ(aria-label)にも使われます |
icon も emoji も書かないと、bolt(稲妻)が出ます。全部これだと見分けが付かないので、 必ず icon を指定してください。
下は、5 個のボタンを設定したヘッダーです。文字は 1 つも出ていないことに注目してください。

同じ画面を、設定していないセルと並べるとこうなります。左が未設定、右が上の設定を入れたもの。

4. run の 4 種類
ボタンが何をするかは run で決めます。4 つしかありません。
run: "input" — エージェントに送る
text をそのセッションに打ち込んで送信します。スラッシュコマンドや、決まり文句のプロンプトに。
{ "id": "compact", "icon": "compress", "label": "Compact this conversation", "run": "input", "text": "/compact" }
run: "shell" — コマンドを実行する
cmd をコマンドセルで実行します。エージェントのセッションは邪魔されません。
{ "id": "test", "icon": "science", "label": "Run the tests", "run": "shell", "cmd": "yarn test" }
押すと、こういうセルが開いて結果が出ます。

cmdの中身はブラウザに渡りません。押した時にサーバがidから引き直し、${変数}を シェルエスケープしてから実行します。
run: "open" — 何かを開く
open の中に書いたキー 1 つで、開くものが決まります。
表は、複数書いてしまったときに効く順(上ほど強い)でもあります。
| キー | 開くもの |
|---|---|
pr | 現在のブランチの PR をブラウザで(PR が無いときはボタン自体が出ません)。サーバ側で url に解決されるため、url を一緒に書いていても PR のほうが勝ちます |
url | ブラウザで URL(http / https のみ) |
reveal | OS のファイルマネージャ(Finder / エクスプローラ / xdg-open) |
files | アプリ内のファイルエクスプローラ |
view | アプリ内のビュー:prs / wiki / collections / accounting(diff も受け付けますが、現状は専用の画面が無くファイルビューが開きます。worktree の差分は差分バッジから) |
terminal | そのディレクトリで新しい端末セル |
pickFile | OS のファイル選択ダイアログ。選んだパスを入力欄に挿入します |
{ "id": "handbook", "icon": "menu_book", "label": "Open the team handbook", "run": "open", "open": { "url": "https://example.com/handbook" } }
1 つのボタンには 1 つだけ書いてください。 複数書くと上の順で最初の 1 つだけが効き、 残りは黙って無視されます。
run: "action" — このセルに対する操作
セル自身に効く操作です(表の最後のツールバーの操作は、アプリに効きます)。名前は キーボードショートカットと同じなので、同じ操作をボタン・キー・コマンドパレットの どれからでも使えます(ツールバーの操作は、パレットでは画面・設定・切り替えの行として出ます):
action | 動作 |
|---|---|
"terminal-new-here" | このセルのディレクトリで起動パネルを開く。Claude・Codex・シェルなどを選んで起動できる(2段目の + と同じ) |
"terminal-new-adjacent" | このセルのディレクトリでシェルをすぐ起動する |
"terminal-restart" | このセルのエージェントを再起動する(下記) |
"terminal-close" | このセルを閉じる |
"zoom-toggle" | このセルを拡大する / 元に戻す |
"terminal-move-prev" / "terminal-move-next" | このセルを1つ前 / 後ろへ移す(手動の並び順のときのみ) |
"mark-unread" | このセルを未読 / 既読にする |
"terminal-park" | このセルを休ませる / 起こす |
"terminal-timeline" | アクティビティのタイムライン(Claude のセッションのみ) |
"terminal-talk" | 他のターミナルと話す |
"terminal-copy-code" | 最新の返事の最後のコードブロックをコピーする(2段目のコピーボタンと同じ) |
"terminal-insert-path" / "terminal-reveal" | 入力欄にファイルのパスを挿入する / ディレクトリをファイルマネージャで開く(パスメニューの項目と同じ) |
"terminal-voice" | 音声入力のオン / オフ(マイク) |
"terminal-diff" / "terminal-note" | 変更パネルを開く(変更のある worktree) / メモを書く・直す |
"pane-files" | このセルの横にファイルペインを開く |
"pane-prompts" / "pane-transcript" | 送ったプロンプト / 会話のペイン |
"pane-tools" / "pane-canvas" / "pane-collections" | 使ったツール / キャンバス / コレクションのペイン |
"screen-wiki"・"screen-collections" など(screen-* のすべて) | その画面へ移動する(ツールバーの入口と同じ) |
"settings-open" / "sound-toggle" / "view-toggle" | 設定を開く / 通知音のオン・オフ / 拡大時の表示を一覧・サムネイル列で切り替える |
"confetti" | 画面いっぱいに紙吹雪を出す(出す種類は Settings の配色(テーマ)の「紙吹雪」でチェックします) |
"order-auto" / "order-manual" / "order-priority" | 並び順を選ぶ |
"page-next" / "page-prev" | グリッドの次 / 前のページへ |
"terminal-reopen" | 最後に閉じたターミナルを開き直す |
ペインのボタンは、ペインが乗っているセル(拡大中のセル、またはタイル表示でペインを開いたセル)ではそのペインの開閉を 切り替えます。ほかのセルでは、「アプリでファイルを見る」と同じくそのセルのペインを開きます(拡大中なら拡大したセルの横、 タイル表示なら拡大せずにグリッドの右)。そのセルでできないとき (Claude 以外のセッションで terminal-timeline、ほかのターミナルが無いときの terminal-talk、手動の 並び順でないときの移動)は、何もしないのではなくセルにその旨が出ます。名前をショートカットと共通に する前の "restart" も、そのまま使えます。
{ "id": "restart", "icon": "restart_alt", "label": "Restart the agent", "run": "action", "action": "terminal-restart" }
"terminal-restart" は、エージェントのプロセスを終了して、同じセル・同じディレクトリ・同じ会話のまま起動し 直します。ランチャーに戻ってディレクトリを選び直し、or resume here から会話を探す必要はありません。 MCP の登録変更・~/.mulmoterminal/config.json の編集・plugin の更新が効くようになるのはこれです。 これらはプロセス起動時に一度だけ読まれるからです。
resume の代償があり、確認は出ません。 会話は transcript から読み直され、実際にトークンを消費します。 作業中でもエージェントは終了します。このボタンのほかに、セルの道具メニューと
terminal-restartショートカットからも再起動できます。
ボタンをフォルダにまとめる
2 段目の幅には限りがあります。たまにしか使わないボタンは、フォルダにまとめられます。 run の代わりに items を持つ項目で、画面にはアイコン 1 つだけが出ます。押すと、中のボタンが アイコンと名前つきでメニューに並びます。
{ "id": "ops", "icon": "construction", "label": "Operations",
"items": [
{ "id": "restart", "icon": "restart_alt", "label": "Restart the agent", "run": "action", "action": "terminal-restart" },
{ "id": "test", "icon": "science", "label": "Run the tests", "run": "shell", "cmd": "yarn test" }
] }
- 入れ子は 1 段だけです。
itemsの中はボタンに限ります。フォルダの中に書いたフォルダは捨てられます。 - フォルダ自体の
whenは、フォルダごと出すかを決めます。中のボタンはそれぞれ自分のwhenを持てます。 中のボタンがすべて隠れるときは、フォルダも出ません。 idはフォルダの中と外を通して一意です。すでに使われているidを持つフォルダ内のボタンは捨てられます。
コマンドパレットにだけ出すコマンド
たまにしか実行しないものに、毎回ヘッダーのアイコンは要りません。buttons の代わりに commands に 書くと、書き方はまったく同じ(run、when、${変数}、フォルダ)で、コマンドパレット (ツールバーのコマンドボタンか、command-palette に割り当てたキー)にだけ出ます。
{ "commands": [
{ "id": "release", "label": "Cut a release", "run": "shell", "cmd": "yarn release" }
] }
~/.mulmoterminal/config.jsonとプロジェクトの.mulmoterminal.jsonのどちらにも書けて、ボタンと同じくidでマージされます。- パレットには、操作の対象のターミナル(拡大中のもの、なければカーソルのあるもの)のコマンドとヘッダーのボタンが全部並びます。
whenと${変数}はそのターミナルについて決まり、shellのコマンドはそこで動きます。対象のターミナルが無いときは並びません。 - ボタンがすでに使っている
idのコマンドは捨てられます。
5. ここから先は「引く」ページへ
ここまでで、ボタンは作れます。この先 —— ${変数} の一覧、when の全記法、global とプロジェクトの マージ、チップ、Skill メニュー、そのまま貼れるレシピ —— は ヘッダーのリファレンスにあります。上から読むページではなく、 書くときに引くページです。
| 知りたいこと | どこ |
|---|---|
${dir} や ${task} に何が入るか、いつ空になるか | ${変数} |
出し分けの条件(!isGitRepo・!=・「値があるとき」) | when |
| global とプロジェクト、2 つの設定ファイルの関係 | 並び順とマージ |
| 1 段目の情報チップを並べ替える・足す | チップ |
| Skill メニューを短くする | Skill メニュー |
全部入りの .mulmoterminal.json | レシピ集 |
関連
- ヘッダーのリファレンス — 変数・
when・マージ・チップ・レシピ集 - 設定 → ヘッダーのカスタマイズ — 全フィールドのリファレンス
- 設定 → プロジェクトごとの設定 — 色・名前・並び順など、同じファイルの他のキー
- 設定 → 「よく使うコマンドを Run メニューに」 —
script.jsonで Run メニューを足す /mulmoterminal-headerスキル — 対話で書いてもらう場合はこちら