---
title: Home
layout: default
nav_order: 1
description: Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs you. 複数の AI コーディングエージェントを並列で回し、どれが自分待ちかを一目で。ローカル・tmux 永続化・MIT。
---

# MulmoTerminal Guide

**AI と一緒にコーディング（vibe coding）してて、こんなこと、ありませんか？**

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

**MulmoTerminal は、この一つひとつに答えます。** 複数の AI コーディングエージェント
（[Claude Code](https://claude.com/claude-code) / **Codex**）を**並行して回し**、状態と所在を**常に見える化**し、
完了を**通知**し、セッションを**落とさず**、git や dir を**ワンクリック**で開ける——**ターミナルを基軸にした現代の開発環境**です。

**Opening too many terminals and losing the thread?** — *which one is doing what*, *which directory*, *what did I even ask it*,
*is it done yet*, *my session vanished when the tab closed*, *typing `git status` / `cd` over and over*. MulmoTerminal answers
each of these: run many AI agents in parallel, always **see** their status and location, get **notified** on completion, **never
lose a session**, and open git/dirs in **one click** — a **terminal-first modern development environment**.

![A board of parallel AI-agent terminals](guide/images/grid-2x2.png)

**インストールと起動は 1 ページにまとまっています / Install and launch, on one page** —
ターミナルの開き方から Node.js・Claude Code・git / gh の入れ方（mac / Windows）まで。
Opening a terminal through installing Node.js, Claude Code and git / gh on macOS and Windows.

[はじめに — 起動するまで](guide/ja/getting-started.html){: .btn .btn-purple .fs-5 .mb-4 .mb-md-0 .mr-2 }
[Getting started (English)](guide/en/getting-started.html){: .btn .fs-5 .mb-4 .mb-md-0 }

> **最新情報は X で発信しています / Follow us on X**
>
> 新バージョンや新機能のお知らせは、X の
> [Singularity Society（@SingularitySoci）](https://x.com/SingularitySoci) で流していきます。
> **ぜひフォローしてください！**
>
> New releases and features are announced on X (in Japanese) —
> [**follow @SingularitySoci**](https://x.com/SingularitySoci) to hear about them first.

## ✨ おすすめ機能 / Highlights

**📋 コックピット・ロスター / The cockpit roster** — 1 体に拡大したまま、横の一覧で全セッションの
**AI 要約・直近の指示・最新の返答・PR フェーズ**（CI fail / ready / merged …）を 1 行ずつ追えます。
Stay zoomed into one agent while a text list tracks every session's **AI summary, last prompt,
latest reply, and PR phase** — the main screen for running many agents.
→ [基本編](guide/ja/basics.html) / [Basics](guide/en/basics.html)

![コックピット・ロスター / The cockpit roster](guide/images/cockpit-roster.png)

**📱 スマホ通知 & リモコン / Phone push & remote control** — タスクの完了・入力待ちを**スマホへ
Web Push**。そのままライブ画面を見て **yes / no / continue** をワンタップで返せます。
Finished / input-waiting turns push to your phone — glance at the live screen and answer with a tap.
→ [設定手順](guide/ja/notifications.html) / [Setup](guide/en/notifications.html)

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

**🌿 worktree 隔離 & ワンクリック PR / Worktrees & one-click PRs** — 同じリポに複数エージェントを
衝突なしで走らせ、diff・コミット・Push・**⧉ Open PR** までセルの中から。
Several agents on one repo without collisions — diff, commit, push, and **⧉ Open PR** from the cell.

## こんなとき → MulmoTerminal / Sound familiar? → Handled

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

## 4 本柱 / Four pillars

**監督 (Supervise)** 並行エージェントのコックピット · **可視化 (See)** 状態と所在を一目 ·
**自動化 & 調査 (Automate & investigate)** 実行と AI 診断 · **拡張 (Extend)** DSL でどんな開発者にも。

## 🚀 起動 / Quick start

> **はじめての方は [はじめに — 起動するまで](guide/ja/getting-started.html) へ。**
> ターミナルの開き方から Node.js・Claude Code・git / gh の入れ方（mac / Windows）、
> つまずいたときの対処まで 1 ページにまとめてあります。
>
> **New here? → [Getting started — from zero to running](guide/en/getting-started.html)** —
> terminal, Node.js, Claude Code, git / gh on macOS and Windows, and troubleshooting, on one page.

**必要なもの:** [`claude`](https://claude.com/claude-code) CLI（Claude Code）· `git` · `gh` が PATH にあること + **Node ≥ 22.9**。
**あると便利:** `tmux`（セッション永続化）· `codex`（Codex セッション）· `ffmpeg`（動画生成）· `ollama`（ローカルモデル）。
→ 各コマンドが何に効くかは [一緒に入れておくコマンド](guide/ja/getting-started.html#cli-tools)。

```bash
npx mulmoterminal@latest                       # → http://localhost:34567 が開く
npx mulmoterminal@latest --cwd ./my-project    # 作業ディレクトリを指定（--port <n> も可）
```

**Prerequisites:** the [`claude`](https://claude.com/claude-code) CLI · `git` · `gh` on your PATH + **Node ≥ 22.9**.
**Also useful:** `tmux` (session persistence) · `codex` (Codex sessions) · `ffmpeg` (video rendering) ·
`ollama` (local models). → what each one unlocks: [The CLIs it drives](guide/en/getting-started.html#cli-tools).

```bash
npx mulmoterminal@latest                        # opens http://localhost:34567
```

**うまく起動しないとき（npx キャッシュ破損）:** 最初の `npx` インストールが途中で中断されると、`~/.npm/_npx/<hash>` が壊れたまま残り、次回起動が `ERR_MODULE_NOT_FOUND` で落ちることがあります（公開パッケージの不具合ではありません）。
ランチャが破損キャッシュを検知して**削除コマンドを表示**するので、それを実行してから再度 `npx mulmoterminal@latest` してください。

**If it won't start (`ERR_MODULE_NOT_FOUND`):** If a first `npx` install was interrupted, a half-unpacked `~/.npm/_npx/<hash>` can remain and a later run fails at startup — a corrupted npx cache, not a bug in the published package.
The launcher detects it and prints the exact removal command; run that, then `npx mulmoterminal@latest` again.

---

## 日本語

- **[はじめに — 起動するまで](guide/ja/getting-started.html)（インストールと起動はここだけで完結）**
- [ガイドのトップ（あるある & コンセプト）](guide/ja/)
- [基本編 — グリッドで今できること](guide/ja/basics.html)
- [よくある質問（FAQ）](guide/ja/faq.html)
- [応用編 — シナリオ別の使い方](guide/ja/scenarios.html)
- [機能一覧](guide/ja/features.html)
- [設定方法](guide/ja/config.html)
- [スマホ通知（Web Push）](guide/ja/notifications.html)
- [OpenRouter で別のモデルを使う](guide/ja/providers.html)
- [claude-ollama でローカルモデル](guide/ja/claude-ollama.html)

## English

- **[Getting started — from zero to running](guide/en/getting-started.html) (install and launch, start to finish)**
- [Guide home (sound familiar? & the concept)](guide/en/)
- [Basics — what you can do in the grid](guide/en/basics.html)
- [FAQ](guide/en/faq.html)
- [Scenarios — workflows by example](guide/en/scenarios.html)
- [Feature reference](guide/en/features.html)
- [Configuration](guide/en/config.html)
- [Mobile notifications (Web Push)](guide/en/notifications.html)
- [Using another model via OpenRouter](guide/en/providers.html)
- [Local models with claude-ollama](guide/en/claude-ollama.html)

---

> Repo: [github.com/receptron/mulmoterminal](https://github.com/receptron/mulmoterminal) ·
> npm: [`mulmoterminal`](https://www.npmjs.com/package/mulmoterminal) — `npx mulmoterminal@latest`

> X: [**@SingularitySoci**](https://x.com/SingularitySoci) — 更新情報はこちらで / follow for updates
