ヘッダーをカスタマイズする

よく使う操作が「ターミナルに打ち込む」しかないと、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 つも出ていないことに注目してください。

ボタンを 5 個設定したヘッダー

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

未設定のセルと設定済みのセル


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" }

押すと、こういうセルが開いて結果が出ます。

run:"shell" のボタンが開いたコマンドセル

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) / メモを書く・直す
"terminal-send-turn" / "terminal-send-since" このターミナルの最後の1往復 / 前回からの分を相手に送り、そちらへ移る — 詳しく
"terminal-bring-turn" / "terminal-bring-since" 相手の最後の1往復 / 前回からの分をここに持ってくる
"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 レシピ集


This site uses Just the Docs, a documentation theme for Jekyll.