---
title: 日本語
layout: default
nav_order: 2
has_children: true
description: 複数の AI コーディングエージェント（Claude Code / Codex）をブラウザのターミナルで並列に動かすコックピット。バイブコーディング（vibe coding）を並列化するための、グリッド・ロスター・git worktree・スマホ通知。
---

# MulmoTerminal ガイド（日本語）

**はじめての方へ。** ターミナルの開き方から、Node.js・Claude Code・git / gh の入れ方
（mac / Windows）、起動コマンド、つまずいたときの対処まで、**インストールと起動は 1 ページ**に
まとめてあります。プログラミングが専門でなくても、そこだけ読めば起動までたどり着けます。
環境がすでに揃っている方は `npx mulmoterminal@latest` だけです。

[はじめに — 起動するまで](getting-started.html){: .btn .btn-purple .fs-5 .mb-4 .mb-md-0 .mr-2 }
[基本編 — 画面の読み方](basics.html){: .btn .fs-5 .mb-4 .mb-md-0 }

> **[4.7.5 で変わったこと](v4.7.5.html)** — **設定を、探せる形と読める言葉で**。設定モーダルが 24 見出しの 1 本スクロールから **9 グループのサイドバー**になり、キーボードではサイドバー全体が Tab 1 回分で、中の移動は矢印キー。モーダル全体が **英語と日本語**で表示できるようになり（既定はブラウザの言語）、**言語**はサイドバーの先頭 — 画面の他が読めない人でも見つけられる位置に置いた。さらに **skill ボタンがエージェントを起動する前に確認する**ようになり、何が起動するかと止め方を伝える。キャンセルすれば設定は元の場所のまま（2026-08-09 時点）
>
> **[4.7.4 で変わったこと](v4.7.4.html)** — **プロジェクトのアイコンがスマホにも届くようになった**。グリッドでセルを見分けている絵（プロジェクトの `.mulmoterminal.json` の `icon`、またはリポジトリがすでに持っている favicon）が、スマホアプリの**ターミナル一覧**と**ターミナル画面**にも出る。一覧では terminal グリフの代わりに出るので、グリフの緑／グレーが担っていた live 表示はアイコン右下の点に移した。**スマホからの `claude` / `codex` 起動**が、空のセル作成フォームで PC の前の人を待つのをやめて実際に起動するようになった。さらに **codex のセッション探索**が、数百バイトを見るために毎秒 149 ファイル / 37 MB を読み直すのをやめた（2026-08-08 時点）
>
> **[4.7.3 で変わったこと](v4.7.3.html)** — **`+ New worktree` が押した回数だけ worktree を作っていた問題を修正**。大きなリポジトリでは `git worktree add` に数秒かかるのに、その間ずっと押す直前と同じ見た目だったので押し増され、そのすべてが成功していた。このセクションのコントロールはすべて処理中は自分をロックしてスピナーを出すようになり、**作成に失敗したときは理由が出る**（これまでは何も出なかった）。**worktree を削除中のセル**は全体がグレイアウトしてスピナーが回り、クリックも Tab 移動もできなくなる。そして **Enter でスクロールした画面が最新の出力へ戻る**ようになった（普通のターミナルと同じ挙動。既定 on、Settings のチェックボックスで切り替え）（2026-08-08 時点）
>
> **[4.7.2 で変わったこと](v4.7.2.html)** — **ターミナルが「別のバックエンドプロセス」に戻ってしまう不具合を修正**。tmux でまだ動いている会話が「空き」に見え、resume すると同じ会話に 2 つ目のバックエンドが起動していた。3 層にわたって修正し、あわせてサーバ再起動後に codex の activity が復帰しなかった問題も解消。**worktree が作業ディレクトリのチップに溜まらなくなり**（すでに保存済みのものは残るので、チップの × で削除）、**コックピットのロスター**は Agent Picker と同じマークと統一された枠に、**コレクションのチャットでエージェントを選べる**ようになり、フォルダボタンは何回押してもファイルダイアログが 1 つだけになった（2026-08-08 時点）
>
> **[4.7.0 で変わったこと](v4.7.0.html)** — **Muse**（動くモデルは **Muse Spark**）が5つ目のエージェントとして Agent Picker に加わり、**GUI ツールにも到達**するようになった。他のどのエージェントとも違う「マシン単位のプラグイン」経由で、`MUSE_EXPERIMENTAL_PLUGINS=1` が要る。**[どの coding agent を使うか](agents.html)** を新設し、5つそれぞれの必要なもの・再開のしかた・GUI ツールへの3通りの経路をまとめた。**Windows** では `.cmd` インストールの Claude セッションが再び起動でき、closing summary をオフにする回避策はもう不要（2026-08-07 時点）
>
> **[4.6.1 で変わったこと](v4.6.1.html)** — round table の会話が**部屋**に残るようになった。追記専用のログで、ツールバーの **Rooms** から開けて、自分で書き込めて、シェルからも `mulmoterminal room` で触れる。話者が読むのは直前の返答だけでなく**それまでの会話全体**になった。**再起動を生き延びたセッション**は Settings に並んで Stop できるようになり、idle なものは次回起動時に終了する。そしてセルが**表示しているコマンド自身を遅くしなくなった** — 同じ重いコマンドを6セルで回して 8.2 秒 → 2.2 秒（2026-08-06 時点）
>
> **[4.6.0 で変わったこと](v4.6.0.html)** — **Round table** が最大5席のリングを指定ターン数だけ自動で回すようになった。セルの forum メニューで席にチェックを入れて start を押すだけ。起動フォームの**履歴が「選んだエージェントのもの」**になり、codex / agy / grok の会話にようやく到達できる。**誰も attach していないまま動いているセッション**はそう表示され、その場で止められる。そして**どのエージェントのセルも**モデル名とコンテキスト使用率を出す。設定は不要 — ただしテーブルを始める前にコストの項だけ読むこと（2026-08-06 時点）
>
> **[4.5.1 で変わったこと](v4.5.1.html)** — `openrouter` 以外の id で登録した接続先が、**押せない行として出るのをやめた**。MODEL の一覧には実際に動かせるものだけが並び、横のリンクが **Needs attention** に変わって「何が足りないか」を1文で出す。**Choose a folder…** は Linux デスクトップと **WSL2 で zenity 無しでも**動くようになり、ダイアログが1つも無いホストではその旨を表示する。設定が要るのはそういう接続先を登録している場合の1行だけ（2026-08-05 時点）
>
> **[4.5.0 で変わったこと](v4.5.0.html)** — リポジトリが**自分でアイコンと色を持てる**ようになった。[`repo.json`](../../repo-json.html) はどのツールからも読めるオープンなメタデータ規格で、リポジトリは一度だけ素性を述べればよい。1色書けばセル全体の配色になり、**favicon を既に持っているリポジトリは設定すら要らない**。git worktree ごとに**dev サーバのポートと DB 名を配れる**ようになり、Agent Picker に **Grok** が加わった（2026-08-05 時点）
>
> **[4.3.1 で変わったこと](v4.3.1.html)** — ランチャーのワークスペースチップが、フォルダ名ではなく役割名 **`WORKSPACE`** で名乗るようになった。**git チップがタブに戻った時点で更新される**（最大 10 秒遅れていたのが解消）。設定は不要（2026-08-04 時点）
>
> **[4.3.0 で変わったこと](v4.3.0.html)** — **ワークスペース**なら起動方法によらず同じ GUI ツールに届くようになり、ランチャーが**常にワークスペースを先頭のチップとして出す**。単一ビューの GUI MCP サーバー ID が **`mt`** になり、エージェントに見えるツール名が短くなった。**IME の変換確定 Enter** はセッションメモでもターミナルでも IME のものになる。設定は不要（2026-08-04 時点）
>
> **[4.2.0 で変わったこと](v4.2.0.html)** — **セルフホストの GitLab** が `gitlabHosts` に書くだけで使えるようになり、**Canvas と Tools のペイン**を端末領域いっぱいに広げられるようになった。新しい **worktree はプロジェクトの設定を色相 1 段ずらして引き継ぎ**、入力を受け付けなくなった端末は**打鍵で自分で直る**か、直せない理由を言う。設定が要るのは 1 キーだけ（2026-08-03 時点）
>
> **[4.1.1 で変わったこと](v4.1.1.html)** — ヘッダーの **usage** が TUI の起動が遅いマシンで `n/a` に張り付かなくなり、スマホのターミナルが1画面ぶんではなく**スクロールバック300行**を返し、GitLab の worktree でも **PR フェーズ pill** と **⧉ Open PR** が GitHub と同じように動く。設定は不要（2026-08-02 時点）
>
> **[4.0.0 で変わったこと](v4.0.0.html)** — **単一ターミナルビューを廃止**。グリッドがアプリそのものになり、1 体に集中するのは「セルを拡大する」こと。コンテンツ系の画面にはツールバーの **Collections** という入口ができた。**worktree は 1 セッションだけ**を持ち、2 つ目の起動を断る。Docker サンドボックスも削除（2026-08-01 時点）
>
> **X で最新情報を発信しています** — 新バージョンや新機能のお知らせは X の [Singularity Society（@SingularitySoci）](https://x.com/SingularitySoci) で流していきます。ここが一番早いので、[**@SingularitySoci をフォローしてください！**](https://x.com/SingularitySoci)
>
> **[❓ よくある質問（FAQ）](faq.html)** — VS Code / Cursor / tmux 分割との違い、**既存の Claude Code セッションはそのまま使えるのか**、Windows で動くのか、トークン代はどうなるのか。試す前に聞かれることをまとめました
>
> **「なんか変」と思ったら** — セッションで `/mulmoterminal-bug-report` と打ってください。同梱スキルが症状を聞き、**実際の**設定とバージョンを読んで仕様・設定で説明がつかないかを先に確かめ、既知の issue を検索し、それでも残ったものだけを報告にまとめます（環境情報は自動収集、鍵はマスク）。
>
> **直したいところがあったら** — **pull request ではなく issue を立ててください。**外部からの PR は規模によらず自動でクローズされます。冷たく聞こえるかもしれませんが、いま足りないのは手ではなく、こちらの環境では踏めないバグと、思いついていないアイデアです。詳細は [CONTRIBUTING.md](https://github.com/receptron/mulmoterminal/blob/main/CONTRIBUTING.md)。

**複数の AI コーディングエージェント（Claude Code / Codex）を、1 つのボードで並行して回す**——
MulmoTerminal はそのためのコックピットです。ブラウザのターミナルなので、エディタを選びません。

**バイブコーディング（vibe coding）は 1 体なら端末で足ります。**このアプリが要るのは、
**並列エージェント（parallel agents）**を回し始めて「どれが今こちらを待っているのか」が
分からなくなってからです。用語は[用語集](glossary.html)にまとめてあります。

まずは看板機能から。

## おすすめ機能

### グリッド — 並行エージェントのコックピット

![並行するエージェント端末のボード](../images/grid-2x2.png)

セルごとに独立したエージェント。**状態の色**（作業中＝青／入力・許可待ち＝琥珀／完了・レビュー待ち＝緑リング）と
**通知音**で、見張らずに「呼ばれたセルだけ」拾えます。→ [基本編](basics.html)

### コックピット・ロスター — 全員の進捗を 1 行ずつ

![コックピット・ロスター — 左に全セッションのサマリー、右に拡大した 1 体](../images/cockpit-roster.png)

1 体に拡大したまま、横の一覧で**全セッションの AI 要約・直近の指示・最新の返答・PR フェーズ**
（draft / CI fail / ready / merged …）を文字で追えます。多数を回すときの主戦場。→ [基本編](basics.html)

### スマホ通知 & リモコン — 席を立っても呼び戻される

![スマホのロック画面に届いた通知](../images/push-lock-screen.jpg)

タスクの完了・入力待ちを**スマホへ Web Push**。そのままスマホでライブ画面を確認し、
**yes / no / continue** のワンタップで返せます。→ [スマホ通知（Web Push）](notifications.html)

### worktree 隔離 & ワンクリック PR

同じリポに複数エージェントを走らせても衝突しない **git worktree**。差分パネル・コミット・Push・
**Open PR** までセルの中から。→ [worktree で作業を隔離する](worktree.html)

### GUI パネル — ターミナルの横に「画面」

エージェントのツール呼び出しを**図・フォーム・画像・書類・動画/スライド（MulmoCast）**として描画。
エージェントはテキストを印字するだけでなく、インターフェースを手渡してきます。→ [機能一覧](features.html)

### tmux 永続化 — セッションは死なない

リロード・再接続・サーバ再起動を跨いで**セッションが生き続けます**。長いビルドも走らせっぱなしで OK。

---

## 移ってきた人が、何が変わったと言っているか

> 以下は、IDE や分割ターミナルから移ってきた方々が**実際に報告してくれた体験**です。
> ベンチマークでも、こちらで計測した数値でもありません。環境によって変わります。

### 「メモリを食わなくなった」

エージェントを分けるために IDE のウィンドウを分けると、**1体につきエディタ・言語サーバー・拡張機能・
ファイルウォッチャーが一式**増えます。**64GB のマシンがカクついていた**が、移ってからはサクサク動く、
という報告がありました。こちらはエージェントがサーバー側の PTY で、UI はブラウザのタブだからです。

### 「別のエージェントに返信しなくなった」

**6枚のペインは全部同じに見えます。** 「別のエージェントのターミナルに返事を打ち込んでいた」
「そもそも何を頼んだんだっけ、を思い出せない」という声が複数ありました。
ある方は「**どの画面も同じ見た目なので、何を見ているかの識別に地味に時間を取られる**」と書いています。

注意力の問題ではなく、**同じ見た目のペインがN枚あると、N個の文脈を頭の中に持ち続けなければならない**
という問題です。**状態の色・名前バッジ・ディレクトリごとの色**は、それを画面側に移すためのものです。

### 「たくさん見ることと、1つをちゃんと読むことが、両立するようになった」

ターミナルを6分割すると、1つ1つが小さすぎて長い返答をスクロールとリサイズなしには読めません
（**4000字の出力でまさにそうなった**、という報告がありました）。だから人は、エージェントを1体増やす
たびに「読みにくさ」を黙って受け入れています。

**グリッド ↔ 拡大の行き来は、そのトレードオフを解消します。** 全体を眺めて、1体を大きくして
きちんと読む。その間もコックピット・ロスターが残り全員を文字で見せ続けます。

### 「今までのセッションがそのまま使えた」

`claude --resume` と同じ仕組みなので、**既存のセッションはそのまま復帰**します。いつも使っている
ディレクトリを開けば、履歴はそこにあります。移行作業も、やり直しもありません。
「**セッション強制終了でコンテキストが飛ばなくなるだけでも移る価値がある**」という声もありました。

---

**10体並べないと元が取れない、ということはありません。** 実際に「**1〜3体**」で移ってきた方もいます。
上に挙げたものはどれも「もっと多く回せる」話ではなく、「**見失わなくなる**」話です。

---

## vibe coding、こんなこと、ありませんか？

AI エージェント（**Claude Code** / **Codex**）と一緒にコーディングしていると——

- 📊 どれが何をしているのか、**状態が分からなくなる**
- 📁 **どのディレクトリ**で動いているのか見失う
- 💭 dir は分かっても、**そもそも何を頼んだんだっけ？**（元の指示を忘れる）
- エージェントが**終わったのに気づかず**、待たせる／待ちぼうける
- 💥 ターミナルを閉じた・落ちた瞬間に**セッションが消える**
- 🌿 git の状態を見たい・フォルダを開きたいのに、**いちいちコマンドを打つ**
- 結局、**ターミナルを軸にサクサク作業したい**だけなのに——

AI エージェントは 1 タスクに数分かかります。1 体を見張ると手が空きっぱなし。数を増やすほど、上のような
「**追いきれない**」場面が増えていきます。ボトルネックは CPU でも端末でもなく、**あなたの注意**です。

## その一つひとつに、こたえます

| こんなとき | MulmoTerminal では |
|---|---|
| 複数ターミナルの**状態**が分からない | グリッドに並べ、**状態の色**（作業中＝青／入力待ち＝琥珀／完了・レビュー待ち＝緑リング）＋通知音で一目（→ [基本編](basics.html)） |
| **どのディレクトリ**か分からない | 各セルに dir・**プロジェクト名バッジ・色**を表示。色分けで即区別（→ [設定](config.html#per-dir)） |
| **元の指示**を忘れる | セルヘッダーに**直近の指示／今やっていること**を常時表示、**Activity timeline** で**ツール履歴**（→ [可視化](features.html)） |
| **完了**に気づきたい | 入力待ちは**琥珀色**、ターン完了は**緑のリング**、どちらも**通知音**。さらに**スマホへ Web Push**（→ [スマホ通知](notifications.html)） |
| **セッションを継続**したい | **tmux 永続化**で、リロード・再接続・サーバ再起動を跨いで生き続ける |
| **git / dir をサッと**開きたい | git ステータスチップ、ワンクリックで **OSのファイルマネージャ(Finder/Explorer等) / アプリ内ファイル / PR** を開く |
| **ターミナル基軸**で効率化 | 上記すべてを端末の上に載せ、**DSL で自分のワークフローに拡張**（→ [設定](config.html#header)） |

## そのための 4 本柱

1. **監督** — グリッドは**並行エージェントのコックピット**。status の色と通知で triage し、呼ばれたセルにだけ行く。
2. **可視化** — 各エージェントの**状態・モデル・コンテキスト量・git・ツール履歴・コスト**を一目で。「どこで何を」が常に見える。
3. **自動化 & エラー調査** — スクリプトをワンクリックで走らせ（稼働中セルの**隣の空きセル**で）、失敗したら**大量のログを AI が短く診断**。
4. **拡張（DSL）** — ヘッダーのボタン／チップ、ランチャ、プロジェクト設定を**小さな DSL で拡張**。どんな開発者にも合う。

## まずは起動 {#cli-tools}

[`claude`](https://claude.com/claude-code)（Claude Code）が動く環境 + **Node ≥ 22.9** があれば、コマンド 1 つで始められます。

```bash
npx mulmoterminal@latest    # → http://localhost:34567 が開く
```

これで動かなかった方・そもそも何を入れればいいのか分からない方は、
**[はじめに — 起動するまで](getting-started.html)** に全部書いてあります。
ターミナルの開き方、Node.js / Claude Code / git / gh の入れ方（mac・Windows 別）、
[一緒に入れておくコマンドの一覧](getting-started.html#cli-tools)、
[つまずいたときの対処](getting-started.html#troubleshooting)まで 1 ページです。

## このガイドの読み方

1. [はじめに — 起動するまで](getting-started.html)（**インストールと起動はここだけで完結**）
2. [基本編 — グリッドで今できること](basics.html)
3. [よくある質問（FAQ）](faq.html)（既存セッション・Windows・トークン代・他ツールとの違い）
4. [応用編 — シナリオ別の使い方](scenarios.html)
5. [機能一覧](features.html)（4 本柱で整理）
6. [セル同士を会話させる](conversation.html)（1往復の受け渡し・円卓・部屋）
7. [設定方法](config.html)（設定モーダル・`config.json`・`.mulmoterminal.json`・**DSL 拡張**）
8. [スマホ通知（Web Push）](notifications.html)（iPhone / Android の設定）
9. [スマホから使う](phone.html)（閲覧・自分のチップで返信・ターミナル起動）
10. [GitHub — PR / Issue 横断ビュー](github.html)（登録リポの未マージ PR と Issue を 1 画面で）
11. [OpenRouter で別のモデルを使う](providers.html)（Kimi / DeepSeek / Gemini などを実測データつきで選ぶ）
12. [claude-ollama でローカルモデルを動かす](claude-ollama.html)（Ollama で完全ローカル・オフライン）
13. [用語集](glossary.html)

> 英語版は [English guide](../en/) にあります。
