mulmoterminal 1.3.1 → 1.5.0

package/README.md

@@ -12,6 +12,10 @@ ping to your phone when a task finishes. One `npx` command, no Electron, no conf
 npx mulmoterminal        # starts on http://localhost:34567 and opens your browser
 ```
 
+![MulmoTerminal's grid view — four live Claude sessions running side by side, each in its own color-coded project](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/grid-2x2-live.png)
+
+*The grid is a **cockpit for parallel agents** — here, four live Claude sessions, each in its own color-coded project. Every cell's header carries what you need to triage at a glance: **model · context %**, **token counts** (`⇡in ⇣out`), the **git branch / changes** chip, and an AI summary of what the agent is doing. A cell's **border color signals state** — working / done (blue), needs-you (amber — e.g. waiting on a permission), idle — with an attention chime so a stuck cell off-screen still pulls you back. Supervise many; only step in where you're called.*
+
 ## Why you'll want it
 
 - **See every agent at once.** A grid of live sessions, each cell color-coded by state —
@@ -46,6 +50,10 @@ sidebar lists every session for the project and reflects, in real time, which ar
 (the agent is thinking) and which **need attention** (waiting for input, or finished with
 output you haven't seen) — driven by Claude/Codex activity hooks the server injects per spawn.
 
+![Single view — one agent in focus, terminal on the left and a GUI panel on the right](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/single-view.png)
+
+*Besides the grid there's a **single view** for focusing on one agent: the conversation/terminal on the left, and a **GUI panel** ("Canvas") on the right where the agent's tool calls render as documents, forms, charts, images, and HTML — not just printed text. Switch between the two with the chat / grid icons in the toolbar.*
+
 **Inserting a file path** — like a native terminal, you can put a file's absolute path into
 the prompt: **drag a file** onto the terminal (works where the browser exposes the path via
 `file://` — Firefox/Safari), or click the **📎 file button** in the terminal header, which
@@ -344,6 +352,10 @@ CLAUDE_CWD=/Users/you/my-project
 The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/config.json`
 (read/written via `GET`/`POST /api/config`):
 
+![The Settings modal — theme, notification sound, PR repos, launch commands, and MCP servers](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/settings.png)
+
+*Open it from the ⚙ button in the toolbar. Pick a **theme**, set a custom **attention sound**, list the repos the cross-repo **PRs & Issues** view should aggregate, add **launch commands** for grid cells, and register your own **MCP servers** — no need to hand-edit the config file.*
+
 | Field        | Meaning |
 | ------------ | ------- |
 | `cwdPresets` | Quick-pick directories offered when launching a terminal. |
@@ -434,6 +446,10 @@ malformed file is ignored.
 }
 ```
 
+![Four projects color-coded in the grid, each in its own palette](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/grid-colors.png)
+
+*As cells pile up it gets hard to tell which project is which. Give each repo a **name badge** and its own colors in `.mulmoterminal.json` and they're unmistakable — `headerColor`/`badgeColor` tint the frame, while `colors` reaches all the way into the **terminal's own background and text**. (The example above dresses four repos in Mondrian / van Gogh / Picasso / Matisse palettes.)*
+
 | Field        | Meaning |
 | ------------ | ------- |
 | `name`       | Label shown as a badge in the terminal/cell header. |
@@ -467,6 +483,7 @@ yarn dev:client         # Vite dev server only
 
 yarn build              # type-check (vue-tsc) + vite build -> dist/
 yarn typecheck:server   # type-check the server (tsconfig.server.json)
+yarn typecheck:test     # type-check the specs (tsconfig.test*.json)
 yarn server             # run backend; serves dist/ + the APIs on :34567
 yarn test               # vitest run
 ```
@@ -475,6 +492,12 @@ The backend is TypeScript run directly via `tsx` (no build step); `server/` is
 type-checked separately through `tsconfig.server.json` (`strict`), kept out of
 the main `build` so the two type-check independently.
 
+Specs sit outside both of those projects, and vitest strips types rather than
+checking them — so `yarn typecheck:test` is what keeps them honest. It mirrors
+the same split: `tsconfig.test.json` (client specs, DOM + `.vue`) and
+`tsconfig.test-server.json` (server specs, node). CI runs it alongside the
+other two.
+
 In dev, open the Vite URL; its proxy forwards `/ws`, `/ws/pubsub`, and `/api` to
 `:34567`. In production, run `yarn build` then `yarn server` and open
 `http://localhost:34567`.
@@ -610,6 +633,10 @@ separate working tree that shares the repo's `.git`, so several agents can work
 repo without colliding. Worktrees live under `~/.mulmoterminal/worktrees/` (override with
 `MULMOTERMINAL_HOME`), and existing ones are listed for reuse.
 
+![An empty cell's launch form — choose the agent, working directory, or a worktree](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/grid-launch-form.png)
+
+*Every empty grid cell shows this launch form: toggle **Claude / Codex**, type a **working directory** (frequent ones autocomplete from your presets), or — in a git repo — name a task under **OR ISOLATE IN A WORKTREE** and hit **＋ New worktree** to start the agent on its own isolated branch. **OR LAUNCH** starts a plain shell or any launch command instead.*
+
 A worktree cell's header carries a **diff badge** (`+<commits> ●<dirty>`); click it for a
 **Changes vs `<base>`** panel (file list + patch) with actions:
 
@@ -635,6 +662,10 @@ independently. Backed by `GET /api/prs` and `GET /api/issues`.
 Each grid cell's header shows two badges for its session, refreshed when a turn finishes
 (from `GET /api/session/:id`):
 
+![A live Claude cell — the header shows the model·context and token badges this section describes](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/grid-cell-live.png)
+
+*Both badges, live on a real Claude session: **`Opus · ctx 5%`** (model family + how full its context window is) and **`⇡427k ⇣1.8k`** (cumulative input / output tokens for the session). They sit in the header's first row alongside the **status dot**, directory, and **git chip** (`⎇ main ●2`), with what the agent is doing to the right; the icon buttons and the **timeline** (🕘) of tool calls are on the second row.*
+
 - **Context badge** — e.g. `Opus · ctx 35%`: the model family plus how full its context
   window is (the *last* turn's input + cache tokens ÷ the model's window — **1M** for
   current-gen Opus / Sonnet / Fable, **200k** otherwise; an unknown model shows the label
@@ -692,8 +723,21 @@ Favorited collections get their own toolbar buttons.
   (pulsing blue), **blocked** (amber — needs a permission / answer), **done** (blue —
   finished, output unreviewed), and **idle** — and the toolbar shows a tally across all
   pages so you notice an off-screen cell that needs you.
+- **Zoom & filmstrip** — a cell's **⤢** enlarges one agent while the rest shrink to
+  thumbnails in a bottom **filmstrip**; click a thumbnail to switch, **⤡** to return to the
+  grid — so you can flip between "see everything" and "focus on one" in a click.
+
+![Zoom — one agent enlarged, the others as a filmstrip along the bottom](https://raw.githubusercontent.com/receptron/mulmoterminal/main/docs/guide/images/grid-zoom.png)
+
 - **Timeline** (🕘) — a read-only per-session activity timeline (tools run, newest first),
   from `GET /api/transcript/timeline`.
+- **Bring another cell's turn here** (💬) — pick another terminal in the grid and its
+  **last completed turn** is pasted into *this* cell's input box, so you can have Claude
+  and Codex look at each other's work (or pull in a session running in a different repo).
+  The excerpt comes from the agent's own log, not the screen buffer, so it carries no
+  ANSI debris and nothing lost to scrollback. It is **pasted, never sent** — you read
+  what arrived and press Enter, in the cell you were already in. A turn still running
+  isn't available yet (Codex writes its rollout only once the turn ends).
 - **Tools pane** — the available GUI tools plus a live tool-call history for the active
   session.
 - **Notifications** (🔔) — a toolbar bell with an unread badge and a dropdown of active
@@ -859,6 +903,7 @@ same-origin-guarded.
 | `GET /api/codex/sessions?cwd=` | Codex sessions for the project (from `~/.codex` rollouts), newest first. |
 | `GET /api/cost?cwd=&session=` | Estimated $ cost — session / today / month. |
 | `GET /api/transcript/timeline?session=&cwd=` | Per-session activity timeline (tools run). |
+| `GET /api/transcript/last-turn?session=&cwd=&agent=` | A session's last completed exchange (`prompt`, `reply`) plus the `text` to paste into another terminal. `agent=codex` reads the codex rollout instead of the Claude transcript. |
 
 **Git & worktrees**
 

package/bin/update-check.d.ts

@@ -0,0 +1,2 @@
+export declare function fetchLatestVersion(pkg?: string): Promise<string | null>;
+export declare function isNewerVersion(latest: string, current: string): boolean;

package/common/dirChrome.ts

@@ -0,0 +1,20 @@
+// The name + fixed-color fields a `.mulmoterminal.json` may set. Shared across the
+// build boundary: the server's DirConfig/PublicDirConfig and the client's DirConfig
+// all extend this, so a field added on one side can't go missing on the other.
+// `theme` and `colors` stay out of it — each side declares them with its own type
+// (the server keeps the validated strings, the client narrows them to xterm's ITheme).
+export interface DirChrome {
+  name: string | null;
+  badgeColor: string | null;
+  // The cell header's own background / text color (grid cell + single view). Hex
+  // #rrggbb, or null to keep the theme default. Distinct from `colors` (the xterm
+  // palette) — these tint the chrome around the terminal, not the terminal itself.
+  headerColor: string | null;
+  headerTextColor: string | null;
+  // The cell frame + accents (grid cell): body background, border, the idle status
+  // dot, and the header's icon buttons. Hex #rrggbb or null for the theme default.
+  cellColor: string | null;
+  cellBorderColor: string | null;
+  dotColor: string | null;
+  buttonColor: string | null;
+}

package/common/themeIds.ts

@@ -0,0 +1,6 @@
+// The app's theme ids, shared across the build boundary: the server's zod schema
+// (config-schema.ts) enumerates them and the client (useTheme.ts) types + validates
+// against them. Kept in common/ so adding a theme is one edit, not two that can
+// drift — same reason THEME_COLOR_KEYS lives here (see themeColors.ts).
+export const THEME_IDS = ["midnight", "nord", "daylight", "solarized"] as const;
+export type ThemeId = (typeof THEME_IDS)[number];

package/dist/assets/{abnfDiagram-VRR7QNED-6nNByj6v-DxXGZ8ah.js → abnfDiagram-VRR7QNED-6nNByj6v-BmTAK_lf.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DC7NPJ_M-E1qyqaHf.js";import"./chunk-WYO6CB5R-B83L_z6I-Be0VbGoJ.js";import"./chunk-VAUOI2AC-DrcykVNK-BCZszPgC.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CqxshQHA-QQH5sWOZ.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DC7NPJ_M-QXgmJCuN.js";import"./chunk-WYO6CB5R-B83L_z6I-ybwRHaqV.js";import"./chunk-VAUOI2AC-DrcykVNK-BSJoRdEM.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CqxshQHA-rfYFgPHl.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};

package/dist/assets/architecture-TIHT7OUA-CYMWc3UT-ChEc_7wP.js

@@ -0,0 +1 @@
+import{f as e}from"./mermaid-parser.core-DC7NPJ_M-QXgmJCuN.js";export{e as createArchitectureServices};