mulmoterminal 2.0.1 → 2.1.1

package/README.md

@@ -70,7 +70,7 @@ output you haven't seen) — driven by Claude/Codex activity hooks the server in
 
 ![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.*
+*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. **The app opens on the grid** (`/`); the single view has its own URL, `/chat`, so you can bookmark either.*
 
 **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
@@ -111,11 +111,23 @@ dotfiles are server-only. The 45 extensions both sides agree on live in
 
 ## Install & run
 
-Requires the [`claude`](https://claude.com/claude-code) CLI on your `PATH` and
-**Node ≥ 22.9**. Optional but recommended: **`tmux`** so terminals survive a server
-restart (see [Session persistence (tmux)](#session-persistence-tmux)), the **`gh`** CLI
-logged in for the PRs/Issues view and one-click PR creation, and — for Codex sessions —
-the **`codex`** CLI on your `PATH`.
+Needs **Node ≥ 22.9**, plus these CLIs on your `PATH`:
+
+| | Tool | What it gives you | Install |
+| --- | --- | --- | --- |
+| **Required** | [`claude`](https://claude.com/claude-code) | every Claude session — this app is a cockpit for it | `npm i -g @anthropic-ai/claude-code`, then run `claude` once to log in |
+| **Required** | `git` | [worktree isolation](#git-worktrees--pull-requests), each cell's branch / unsaved-dot / diff readout, the PR footer | `brew install git` · `sudo apt install git` · `sudo dnf install git` · Windows: [git-scm.com](https://git-scm.com/download/win) |
+| **Required** | `gh` | the cross-repo **PRs & Issues** view and one-click PR creation — it uses your `gh` login, so no token is stored | [cli.github.com](https://cli.github.com), then `gh auth login` |
+| Recommended | `tmux` | [session persistence](#session-persistence-tmux) — terminals survive a server restart | `brew install tmux` · `sudo apt install tmux` · `sudo dnf install tmux` · no native Windows build (falls back to plain PTYs) |
+| Optional | `codex` | [Codex sessions](#agents-claude--codex) in a cell, alongside Claude | `npm i -g @openai/codex` |
+| Optional | `docker` | the experimental [Docker sandbox](#docker-sandbox-experimental-single-view) | [docs.docker.com](https://docs.docker.com/get-started/get-docker/) |
+| Optional | `ffmpeg` | video rendering from the [mulmo-script panel](#wiki-collections--the-gui-panel) (its plugin ships enabled) | `brew install ffmpeg` · `sudo apt install ffmpeg` · `sudo dnf install ffmpeg` |
+| Optional | `ollama` | [`claude-ollama`](https://receptron.github.io/mulmoterminal/guide/en/claude-ollama.html) — Claude Code against a fully local model | [ollama.com/download](https://ollama.com/download) |
+
+The server starts without any of the non-required rows; you just lose that row's feature,
+and the header/panel for it says so. `git` and `gh` are marked required because losing them
+costs whole views rather than one button. `npx mulmoterminal init` (below) reports which of
+these it can find.
 
 ```bash
 npx mulmoterminal           # start on http://localhost:34567 and open the browser
@@ -124,8 +136,8 @@ npm install -g mulmoterminal
 mulmoterminal
 ```
 
-**First-run setup (optional).** `npx mulmoterminal init` checks your environment (Node ≥ 22.9,
-the `claude` CLI, plus optional `tmux` / `gh` / `codex`), seeds the launcher's **directory
+**First-run setup (optional).** `npx mulmoterminal init` checks your environment (Node ≥ 22.9
+and every CLI in the table above), seeds the launcher's **directory
 presets** from the projects in your Claude Code history, and writes `~/.mulmoterminal/config.json`.
 It's **idempotent** — re-run it any time to refresh the presets; it overwrites the managed parts
 and keeps your other settings. When `claude` is installed it can hand off to the
@@ -434,7 +446,7 @@ The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/confi
 
 ![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.*
+*Open it from the ⚙ button in the toolbar. Pick a **theme**, set the **terminal font size**, 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. Note that **theme and font size are stored per browser** (they're display preferences, so a phone and a desktop keep their own); the rest live in `~/.mulmoterminal/config.json` and are shared by every client.*
 
 | Field        | Meaning |
 | ------------ | ------- |
@@ -451,6 +463,7 @@ The Settings modal (⚙) persists per-user UI choices to `~/.mulmoterminal/confi
 | `worklogEnabled` | `true` to run the built-in **dev worklog** batch (see below). Off by default (each run spawns an LLM session, so it costs tokens). |
 | `worklogIntervalHours` | Worklog cadence in hours (default `6`, clamped to `1`–`168`). |
 | `terminalSubmit` | Which bytes Claude reads as **submit** vs **newline**: `"cr"` (default — Enter submits, Shift+Enter makes a newline) or `"esc-cr"` (for a Claude Code rebound the other way). Applies to the keyboard **and** the phone remote-view submit, for **Claude sessions only** (shell/codex keep plain Enter). See the [Configuration guide](https://receptron.github.io/mulmoterminal/guide/en/config.html#terminal-submit). |
+| `prWorkdirFooter` | Ends the body of a PR **⧉ Open PR** creates with `work in <clone>` — the directory name of the clone the work happened in, so a PR says which of several side-by-side checkouts produced it. **On by default**; set `false` to opt out — read from the file per PR, so no restart is needed (there is no Settings control for it). Only applied to PRs this app creates (pressing the button again on an existing PR never re-appends). |
 
 #### Header buttons
 
@@ -527,6 +540,7 @@ malformed file is ignored.
   "buttonColor": "#c7cdf0",             // header icon buttons (hex #rrggbb)
   "theme": "nord",                      // terminal palette: midnight | nord | daylight | solarized
   "colors": { "background": "#190a23", "cursor": "#ff2e63" }, // per-key palette overrides
+  "fontSize": 16,                       // terminal font size in px (8–32); overrides Settings
   "sound": "./.mulmoterminal/alert.mp3" // attention sound, RELATIVE to this directory
 }
 ```
@@ -547,6 +561,7 @@ malformed file is ignored.
 | `buttonColor` | Header **icon button** color (`#rrggbb`) — expand / close / attach / folder / etc., across both header rows. |
 | `theme`      | xterm palette for terminals in this directory (one of the built-in theme ids). |
 | `colors`     | Per-key xterm palette overrides applied on top of `theme` (or the app theme when `theme` is unset). Keys are xterm `ITheme` names (`background`, `foreground`, `cursor`, `selectionBackground`, the 16 ANSI colors, …); values are hex (`#rgb` / `#rrggbb` / `#rrggbbaa`). Unknown keys / bad values are dropped. |
+| `fontSize`   | Terminal font size in px for this directory (8–32), overriding the Settings value. A size outside the range is clamped; a non-number is ignored. Changing it re-fits the terminal, so the PTY learns the new width — unlike browser zoom, which leaves the two disagreeing. |
 | `sound`      | Attention sound for this directory's sessions, a path **relative to the directory** (served at `GET /api/dir-sound`). |
 
 **Security.** `sound` is a directory-relative path only — absolute paths and any
@@ -835,7 +850,10 @@ Favorited collections get their own toolbar buttons.
 - **Notifications** (🔔) — a toolbar bell with an unread badge and a dropdown of active
   notifications; click a row to jump to its session.
 - **Voice input** — dictate a prompt via on-device Whisper (`POST /api/transcribe`, macOS
-  only; the model downloads on first use).
+  only; the model downloads on first use). Settings picks **the language you dictate in**
+  (per browser): your browser's, whisper's own per-clip detection, or a fixed one. Worth
+  setting — speech in a language the mic is not expecting comes back *translated* into the
+  one it is, so an English browser silently turned Japanese dictation into English.
 - **Remote host** — link MulmoTerminal to the companion phone client (Google sign-in) to
   watch and start sessions from your phone.
 - **Themes** — four terminal palettes (midnight / nord / daylight / solarized), your pick

package/bin/mulmoterminal.js

@@ -76,6 +76,31 @@ function claudeInstalled() {
   return hasCommand("claude");
 }
 
+// PATH tools the app shells out to; mirrors the requirements table in README.md. `required`
+// ones back the core grid — without them a developer loses whole views rather than one
+// feature — so a miss is an ✗, not an ○.
+const PATH_TOOLS = [
+  { cmd: "git", versionArg: "--version", required: true, why: "worktrees, per-cell branch/diff, PR footer", hint: "brew install git  ·  apt install git" },
+  { cmd: "gh", versionArg: "--version", required: true, why: "PRs & Issues view + one-click PRs", hint: "https://cli.github.com  (then: gh auth login)" },
+  { cmd: "tmux", versionArg: "-V", required: false, why: "sessions survive a restart", hint: "brew install tmux  ·  apt install tmux" },
+  { cmd: "codex", versionArg: "--version", required: false, why: "run OpenAI Codex as an agent", hint: "npm install -g @openai/codex" },
+  { cmd: "docker", versionArg: "--version", required: false, why: "the experimental Docker sandbox", hint: "https://docs.docker.com/get-started/get-docker/" },
+  {
+    cmd: "ffmpeg",
+    versionArg: "-version",
+    required: false,
+    why: "video rendering in the mulmo-script panel",
+    hint: "brew install ffmpeg  ·  apt install ffmpeg",
+  },
+  { cmd: "ollama", versionArg: "--version", required: false, why: "a fully local model via claude-ollama", hint: "https://ollama.com/download" },
+];
+
+function toolCheckLine({ cmd, versionArg, required, why, hint }) {
+  if (hasCommand(cmd, versionArg)) return `  ✓ ${cmd} — ${why}`;
+  const head = required ? `  ✗ ${cmd} — not found, needed for ${why}` : `  ○ ${cmd} — optional (${why})`;
+  return `${head}\n      → ${hint}`;
+}
+
 function promptYesNo(question) {
   return new Promise((res) => {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -103,13 +128,7 @@ async function runInit(initArgs) {
     console.log("      → npm install -g @anthropic-ai/claude-code   (then run `claude` and log in)");
   }
 
-  for (const [cmd, versionArg, why, hint] of [
-    ["tmux", "-V", "sessions survive a restart", "brew install tmux  ·  apt install tmux"],
-    ["gh", "--version", "PRs & Issues view + one-click PRs", "https://cli.github.com  (then: gh auth login)"],
-    ["codex", "--version", "run OpenAI Codex as an agent", "npm install -g @openai/codex"],
-  ]) {
-    console.log(hasCommand(cmd, versionArg) ? `  ✓ ${cmd} — ${why}` : `  ○ ${cmd} — optional (${why})\n      → ${hint}`);
-  }
+  PATH_TOOLS.forEach((tool) => console.log(toolCheckLine(tool)));
 
   // Config half: derive working-dir presets from Claude history + write config.json.
   console.log("");

package/common/cockpitLines.ts

@@ -0,0 +1,46 @@
+// How many lines each row of the cockpit roster (the list beside a zoomed terminal) shows before
+// it clamps. The roster trades two things against each other: how many sessions fit on screen,
+// and how much of each one you can read without opening it. 2/2/3 is the tight end — it fits a
+// long roster, but a summary written as a full sentence gets cut mid-thought, which is exactly
+// when you wanted to read it. That is a trade the user should get to make, not a bug to fix, so
+// the defaults stay put and the knob is opt-in.
+//
+// One knob per field: the three are worth different amounts. A summary says what a session is
+// doing NOW, while a prompt is usually done in two lines.
+//
+// Shared because both sides decide from it: the server sanitizes and serves it, the grid renders
+// from it. The CSS that applies the clamp is NOT here — the server has no use for it (#877).
+
+import { isRecord } from "./isRecord.js";
+
+export interface CockpitLines {
+  summary: number;
+  prompt: number;
+  response: number;
+}
+
+export const DEFAULT_COCKPIT_LINES: CockpitLines = { summary: 2, prompt: 2, response: 3 };
+
+// 1 is "one line, still clamped". Past ~20 a single row fills the column and the roster stops
+// being a roster.
+export const COCKPIT_LINES_MIN = 1;
+export const COCKPIT_LINES_MAX = 20;
+
+// Clamp an out-of-range number and round a fractional one — the contract normalizeFontSize
+// states for the font size, for the same reason: on a bounded number the user asked for a
+// DIRECTION, so honouring it reads as working where falling back to the default reads as
+// ignored. Non-numeric is a different thing — "nothing configured here" — and falls back.
+const oneField = (input: unknown, fallback: number): number => {
+  if (typeof input !== "number" || !Number.isFinite(input)) return fallback;
+  return Math.min(COCKPIT_LINES_MAX, Math.max(COCKPIT_LINES_MIN, Math.round(input)));
+};
+
+/** Per field, so one typo can't discard the two the user set correctly. */
+export function sanitizeCockpitLines(input: unknown): CockpitLines {
+  if (!isRecord(input)) return { ...DEFAULT_COCKPIT_LINES };
+  return {
+    summary: oneField(input.summary, DEFAULT_COCKPIT_LINES.summary),
+    prompt: oneField(input.prompt, DEFAULT_COCKPIT_LINES.prompt),
+    response: oneField(input.response, DEFAULT_COCKPIT_LINES.response),
+  };
+}

package/common/dirChrome.ts

@@ -1,4 +1,4 @@
-// The name + fixed-color fields a `.mulmoterminal.json` may set. Shared across the
+// The `.mulmoterminal.json` fields whose type is the SAME on both sides. 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
@@ -17,6 +17,10 @@ export interface DirChrome {
   cellBorderColor: string | null;
   dotColor: string | null;
   buttonColor: string | null;
+  // xterm font size in px for terminals opened here, or null to use the global setting.
+  // Unlike the colors above, this changes the cell metrics — every path that applies it has
+  // to re-fit and push the new cols/rows to the PTY, or the grid drifts from the canvas.
+  fontSize: number | null;
 }
 
 // "Nothing configured" — the base every DirConfig/PublicDirConfig empty spreads, so adding
@@ -32,4 +36,5 @@ export const EMPTY_DIR_CHROME: Readonly<DirChrome> = {
   cellBorderColor: null,
   dotColor: null,
   buttonColor: null,
+  fontSize: null,
 };

package/common/terminalFontSize.ts

@@ -0,0 +1,20 @@
+// The xterm font size, in px. Shared because all three sides decide from the same numbers:
+// the server validates `.mulmoterminal.json`, the Settings stepper bounds its own buttons, and
+// the client validates what it reads back out of localStorage.
+export const TERMINAL_FONT_SIZE_DEFAULT = 14;
+// Below ~8px the canvas renderer's glyphs stop being legible; above ~32px a grid cell holds so
+// few columns that Claude's output wraps into noise. Neither is a hard xterm limit — they bound
+// the stepper and reject a value that would leave the terminal unusable.
+export const TERMINAL_FONT_SIZE_MIN = 8;
+export const TERMINAL_FONT_SIZE_MAX = 32;
+export const TERMINAL_FONT_SIZE_STEP = 1;
+
+// Clamp rather than reject an out-of-range number: for a size, honouring the direction the user
+// asked for reads as working, where falling back to the default reads as ignored. Non-numeric
+// input is a different thing — "nothing configured here" — so it stays null and lets the caller
+// fall back. Fractional sizes round: xterm accepts them, but they make cell metrics drift from
+// the integer the UI shows.
+export function normalizeFontSize(input: unknown): number | null {
+  if (typeof input !== "number" || !Number.isFinite(input)) return null;
+  return Math.min(TERMINAL_FONT_SIZE_MAX, Math.max(TERMINAL_FONT_SIZE_MIN, Math.round(input)));
+}

package/common/voiceInputStatus.ts

@@ -0,0 +1,21 @@
+// The `GET /api/transcribe/model` response. The server builds it; the UI decides the mic
+// button's visibility and the settings section's from it — both sides read it, so it lives
+// here rather than as one interface per side.
+//
+// Deliberately independent of whisper's own types: this is the API contract, and which
+// package implements transcription behind it is not the UI's business. The server's
+// `getVoiceInputStatus(): VoiceInputStatus` annotation is what keeps the two in step.
+
+export type VoiceModelState = "idle" | "downloading" | "ready" | "error";
+
+export interface VoiceInputStatus {
+  /** The platform and binaries are present — the mic can appear. */
+  capable: boolean;
+  model: {
+    name: string;
+    state: VoiceModelState;
+    /** 0..1, only while downloading and only when the size is known. */
+    progress?: number;
+    error?: string;
+  };
+}

package/dist/assets/{abnfDiagram-VRR7QNED-RjiYivmv-CMyzg2zY.js → abnfDiagram-VRR7QNED-RjiYivmv-1RrSDjxg.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-DxEa8E3F-D1ef8DoR.js";import"./chunk-WYO6CB5R-BlzOfotS-qckQG4MR.js";import"./chunk-VAUOI2AC-CS9QJ4yz-DviHNtmN.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-CG59XkeN.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-DxEa8E3F-BAh0ySn4.js";import"./chunk-WYO6CB5R-BlzOfotS-BRwSb4rl.js";import"./chunk-VAUOI2AC-CS9QJ4yz-CfgcnwuB.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-CKo27qok.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-0NsD2xW1-CtE1YID5.js

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