mulmoterminal 11.0.0 → 11.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/README.md +43 -5
  2. package/bin/mulmoterminal.js +6 -1
  3. package/common/gitlabHosts.ts +1 -1
  4. package/common/terminalUnicode.ts +13 -0
  5. package/common/usageGauge.ts +23 -0
  6. package/dist/assets/{abnfDiagram-WEYOIA3C-DVq8kuW-.js → abnfDiagram-WEYOIA3C-Cmp4Tx5W.js} +1 -1
  7. package/dist/assets/{architecture-WOLXFQ4H-C7BGcdK-.js → architecture-WOLXFQ4H-ByYyhTLK.js} +1 -1
  8. package/dist/assets/{architectureDiagram-ZHVYKT53-DNGWcepk.js → architectureDiagram-ZHVYKT53-C_Ndn-Je.js} +1 -1
  9. package/dist/assets/{blockDiagram-RJAE7QA3-CGZ9RuWx.js → blockDiagram-RJAE7QA3-mlOk2zhP.js} +1 -1
  10. package/dist/assets/{c4Diagram-XDPPPE54-DZmC88ww.js → c4Diagram-XDPPPE54-CFTnN0HB.js} +1 -1
  11. package/dist/assets/channel-ByI_si1E.js +1 -0
  12. package/dist/assets/{chunk-2E7WHVMD-D7xIRLSq.js → chunk-2E7WHVMD-BetO9SrX.js} +1 -1
  13. package/dist/assets/{chunk-4EMNKR2T-Dzvh5fOO.js → chunk-4EMNKR2T-zxhkWbfJ.js} +1 -1
  14. package/dist/assets/{chunk-55XCU76K-BTE3Y9bK.js → chunk-55XCU76K-B_TvWamU.js} +1 -1
  15. package/dist/assets/{chunk-7S6XSTFO-DsK-rIkY.js → chunk-7S6XSTFO-Bc-mSoBi.js} +1 -1
  16. package/dist/assets/{chunk-AQDTSKZB-4cKWLowg.js → chunk-AQDTSKZB-C9HoxKuY.js} +1 -1
  17. package/dist/assets/{chunk-DSNLSHJZ-JVf11DZn.js → chunk-DSNLSHJZ-DK1kK-FT.js} +1 -1
  18. package/dist/assets/{chunk-HAGFOTED-B_03bYIk.js → chunk-HAGFOTED-DmQJSt5s.js} +1 -1
  19. package/dist/assets/{chunk-HNE4Q36P-eSOGFNd9.js → chunk-HNE4Q36P-eCOAIPf0.js} +1 -1
  20. package/dist/assets/{chunk-NQOKRVIF-DrKnqaZ9.js → chunk-NQOKRVIF-DHYkxnQm.js} +1 -1
  21. package/dist/assets/{chunk-UHW7PFBP-hvtR8KO-.js → chunk-UHW7PFBP-Cufg30g_.js} +1 -1
  22. package/dist/assets/{chunk-VQ5W62QI-BA7w1RJc.js → chunk-VQ5W62QI-pCteIrN_.js} +1 -1
  23. package/dist/assets/{chunk-WQQL4CDK-DX3v7lRx.js → chunk-WQQL4CDK-L6JwAJYt.js} +1 -1
  24. package/dist/assets/{chunk-YZO67HFG-Ibnx2Otl.js → chunk-YZO67HFG-l26i9-fW.js} +1 -1
  25. package/dist/assets/{chunk-ZAUX2LTX-CV2OdzaG.js → chunk-ZAUX2LTX-BjQtCnUa.js} +1 -1
  26. package/dist/assets/{chunk-ZCHMQSOR-BanBhArD.js → chunk-ZCHMQSOR-DqM-PcNO.js} +1 -1
  27. package/dist/assets/{classDiagram-v2-4MYWR3UA-yZjONpMD.js → classDiagram-v2-4MYWR3UA-DUrsgm6B.js} +1 -1
  28. package/dist/assets/{cynefin-EF2NZ3EQ-BZLYG6oM.js → cynefin-EF2NZ3EQ-BKpYlaEL.js} +1 -1
  29. package/dist/assets/{cynefinDiagram-WF24UDRP-C0bymUOv.js → cynefinDiagram-WF24UDRP-B96MwjXz.js} +1 -1
  30. package/dist/assets/{dagre-NK4GIZVX-_7rSwolX.js → dagre-NK4GIZVX-CxeK3aZH.js} +1 -1
  31. package/dist/assets/{diagram-CBK3MWTC-BbxJK9a6.js → diagram-CBK3MWTC-9LPDXxIk.js} +1 -1
  32. package/dist/assets/{diagram-I5XIIV2D-Djp7i-lD.js → diagram-I5XIIV2D-BvBw8bi1.js} +1 -1
  33. package/dist/assets/{diagram-ODIL2UCW-CxgrEBTh.js → diagram-ODIL2UCW-DqSh8H4y.js} +1 -1
  34. package/dist/assets/{diagram-PFBEJUXE-DLjuFnaR.js → diagram-PFBEJUXE-DWWAZljf.js} +1 -1
  35. package/dist/assets/{diagram-RJA3I4VV-COsWioES.js → diagram-RJA3I4VV-D8keEzXf.js} +1 -1
  36. package/dist/assets/{diagram-TYUNFSNR-CJ8qa13i.js → diagram-TYUNFSNR-BfWi1ADj.js} +1 -1
  37. package/dist/assets/{dist-8FdwUUJQ.js → dist-BQ7yPAA7.js} +4 -4
  38. package/dist/assets/dist-Bmoz5E2r.js +11 -0
  39. package/dist/assets/dist-BwhEbr8Z.js +1 -0
  40. package/dist/assets/{dist-C6cB8194.js → dist-CzOVujlk.js} +1 -1
  41. package/dist/assets/dist-DGIhaHeq.js +2 -0
  42. package/dist/assets/dist-DsIb-rrF.js +9 -0
  43. package/dist/assets/{dist-BOGKDg8G.js → dist-rXle-a-N.js} +1 -1
  44. package/dist/assets/{ebnfDiagram-V4P3TTPT-DurgMvJ_.js → ebnfDiagram-V4P3TTPT-CHN8aEhs.js} +1 -1
  45. package/dist/assets/echarts-gl-BrLie52P.js +4282 -0
  46. package/dist/assets/{elk-QONTBCTQ-C3ZsNcrX.js → elk-QONTBCTQ-CshBL2IP.js} +1 -1
  47. package/dist/assets/{emscripten-module-Q67P5WYC-Bmd1kZ-n.js → emscripten-module-Q67P5WYC-DTquyAv8.js} +1 -1
  48. package/dist/assets/{erDiagram-KYQIGQAA-BLT-v4py.js → erDiagram-KYQIGQAA-D1kL5AWH.js} +1 -1
  49. package/dist/assets/{eventmodeling-K75KTNOO-6Iws80wv.js → eventmodeling-K75KTNOO-B8dx6476.js} +1 -1
  50. package/dist/assets/flowDiagram-IUGLLWBU-CEjAL_z9.js +1 -0
  51. package/dist/assets/{ganttDiagram-R7GPNTJY-BmXhNThm.js → ganttDiagram-R7GPNTJY-BSPKOv-6.js} +1 -1
  52. package/dist/assets/{gitGraph-VSP46ZUC-CkkPtWcD.js → gitGraph-VSP46ZUC-CzibcN63.js} +1 -1
  53. package/dist/assets/{gitGraphDiagram-PDYL7XHY-CYzrcSNR.js → gitGraphDiagram-PDYL7XHY-D9Rc_6ko.js} +1 -1
  54. package/dist/assets/index-eeJFF9YM.css +1 -0
  55. package/dist/assets/{index-BpmrnmjW.js → index-egSprPVf.js} +598 -588
  56. package/dist/assets/{info-OHQRW6UA-DUn3Epga.js → info-OHQRW6UA-D0jRyoJc.js} +1 -1
  57. package/dist/assets/{infoDiagram-MVDRKAX5-DU4IQjQk.js → infoDiagram-MVDRKAX5-Cemw2pXz.js} +1 -1
  58. package/dist/assets/{ishikawaDiagram-HPEHV2GE-BvLKjYPe.js → ishikawaDiagram-HPEHV2GE-cURQwqNX.js} +1 -1
  59. package/dist/assets/japan-CyDc-cz7-BgORDJsl.js +1 -0
  60. package/dist/assets/{journeyDiagram-BOSHW7O7-DpHLl0yL.js → journeyDiagram-BOSHW7O7-Dv4PYNSI.js} +1 -1
  61. package/dist/assets/{kanban-definition-FNSA4HC5-C6JdCaG-.js → kanban-definition-FNSA4HC5-9u5QcGby.js} +1 -1
  62. package/dist/assets/{line-Bw6Xc2ab.js → line-CuFC1YCV.js} +1 -1
  63. package/dist/assets/{manifold-jnEin-wZ.js → manifold-CrmgLTpS.js} +1 -1
  64. package/dist/assets/{mermaid-parser.core-CNDAB8o0.js → mermaid-parser.core-C61BrrC3.js} +3 -3
  65. package/dist/assets/{mermaid.core-CoL-f9aD.js → mermaid.core-Cl24-ZEG.js} +4 -4
  66. package/dist/assets/{mindmap-definition-6OY57UG3-BhBmdCov.js → mindmap-definition-6OY57UG3-BRgPK5JB.js} +1 -1
  67. package/dist/assets/{packet-JDAUHWVQ-C35misKe.js → packet-JDAUHWVQ-CKUjzIJ0.js} +1 -1
  68. package/dist/assets/{pegDiagram-ECIUJNBX-DS56qD-d.js → pegDiagram-ECIUJNBX-C1J-b8NU.js} +1 -1
  69. package/dist/assets/{pie-XZMESJXO-Di-_LmdX.js → pie-XZMESJXO-CEoI0vgI.js} +1 -1
  70. package/dist/assets/{pieDiagram-GNMPY74T-CoNkNE3i.js → pieDiagram-GNMPY74T-1rjZUkBp.js} +1 -1
  71. package/dist/assets/{quadrantDiagram-D57K4MC3-hakXlWme.js → quadrantDiagram-D57K4MC3-Z5o24iA9.js} +1 -1
  72. package/dist/assets/{radar-ABXABTNO-jWKRHqeD.js → radar-ABXABTNO-DlMQ9BIQ.js} +1 -1
  73. package/dist/assets/{railroad-I3PHUGI6-CEIgG01D.js → railroad-I3PHUGI6-aLH52CWH.js} +1 -1
  74. package/dist/assets/{railroad-abnf-LNEFI6M7-C6vnZFm7.js → railroad-abnf-LNEFI6M7-CNY9JmCj.js} +1 -1
  75. package/dist/assets/{railroad-ebnf-DWYD2UWJ-Ct_jkHRX.js → railroad-ebnf-DWYD2UWJ-6ZkiOQTl.js} +1 -1
  76. package/dist/assets/{railroad-peg-JR7BVNR7-95BYyUc5.js → railroad-peg-JR7BVNR7-ThD3G00i.js} +1 -1
  77. package/dist/assets/{railroadDiagram-Y72NRBL7-BxFBB3DV.js → railroadDiagram-Y72NRBL7-6kTe3oJJ.js} +1 -1
  78. package/dist/assets/{requirementDiagram-EQYSW5RA-B6e48jRX.js → requirementDiagram-EQYSW5RA-WVjSxY44.js} +1 -1
  79. package/dist/assets/{sankeyDiagram-SY24JHO5-CQw7AOdH.js → sankeyDiagram-SY24JHO5-BZSFsOEk.js} +1 -1
  80. package/dist/assets/{sequenceDiagram-BLEHNHQU-CqrU0bWO.js → sequenceDiagram-BLEHNHQU-CTRdxaro.js} +1 -1
  81. package/dist/assets/{stateDiagram-v2-A6IESKWZ-CV0xewo7.js → stateDiagram-v2-A6IESKWZ-CxUltWSI.js} +1 -1
  82. package/dist/assets/{swimlanes-B3ENRKFQ-Dssfyer6.js → swimlanes-B3ENRKFQ-lFZQyH47.js} +1 -1
  83. package/dist/assets/swimlanesDiagram-AYQRV4AK-BXbWl8de.js +8 -0
  84. package/dist/assets/{timeline-definition-JXYKGLGB-g-QBOvoo.js → timeline-definition-JXYKGLGB-DU03RLMk.js} +1 -1
  85. package/dist/assets/{treeView-D4JQ5SDB-rxuH2Z_1.js → treeView-D4JQ5SDB-Bs89H1hR.js} +1 -1
  86. package/dist/assets/{treemap-SAJKECNS-BsglXoh8.js → treemap-SAJKECNS-ByfklI4Z.js} +1 -1
  87. package/dist/assets/{usecaseDiagram-WPOLBNNX-CGsssUfu.js → usecaseDiagram-WPOLBNNX-D1iPvRwz.js} +1 -1
  88. package/dist/assets/{vennDiagram-Q3Y3IDCW-lvzH74S9.js → vennDiagram-Q3Y3IDCW-Ct0bHUSJ.js} +1 -1
  89. package/dist/assets/{wardley-7MLQ67FV-DTVybz2d.js → wardley-7MLQ67FV-C4LJYZlm.js} +1 -1
  90. package/dist/assets/{wardleyDiagram-IVAIDKWA-9JpttuR9.js → wardleyDiagram-IVAIDKWA-BLRjtVoA.js} +1 -1
  91. package/dist/assets/world-R-tMZ4nZ-B1c4T9X2.js +1 -0
  92. package/dist/assets/{xychartDiagram-4URNHDU4-C54d--FQ.js → xychartDiagram-4URNHDU4-CsrT2K78.js} +1 -1
  93. package/dist/index.html +3 -2
  94. package/docs/ChangeLog.md +63 -0
  95. package/docs/facts.json +7 -1
  96. package/docs/guide/en/alternatives.md +21 -1
  97. package/docs/guide/en/config.md +6 -4
  98. package/docs/guide/en/faq.md +1 -1
  99. package/docs/guide/en/feature-list.md +6 -1
  100. package/docs/guide/en/features.md +4 -2
  101. package/docs/guide/en/getting-started.md +7 -4
  102. package/docs/guide/en/github.md +78 -49
  103. package/docs/guide/en/index.md +2 -2
  104. package/docs/guide/en/spreadsheet.md +16 -4
  105. package/docs/guide/en/v11.1.0.md +150 -0
  106. package/docs/guide/ja/alternatives.md +18 -0
  107. package/docs/guide/ja/config.md +6 -4
  108. package/docs/guide/ja/faq.md +1 -1
  109. package/docs/guide/ja/feature-list.md +6 -1
  110. package/docs/guide/ja/features.md +4 -2
  111. package/docs/guide/ja/getting-started.md +7 -4
  112. package/docs/guide/ja/github.md +117 -89
  113. package/docs/guide/ja/index.md +2 -2
  114. package/docs/guide/ja/spreadsheet.md +14 -3
  115. package/docs/guide/ja/v11.1.0.md +142 -0
  116. package/package.json +4 -3
  117. package/server/agents/probe/probe-transcript.spec.ts +81 -1
  118. package/server/agents/probe/probe-transcript.ts +34 -2
  119. package/server/agents/rate-limit/account-rate-limits.ts +6 -5
  120. package/server/agents/rate-limit/rate-limit-routes.ts +21 -2
  121. package/server/agents/rate-limit/rate-limit-service.ts +2 -2
  122. package/server/agents/rate-limit/rate-limit-store.spec.ts +15 -0
  123. package/server/agents/rate-limit/rate-limit-store.ts +12 -5
  124. package/server/config/app-config.ts +14 -0
  125. package/server/config/config-routes.ts +40 -17
  126. package/server/files/files-browse.ts +1 -1
  127. package/server/files/renderedDoc.ts +4 -3
  128. package/server/infra/fs/legacy-cleanup.ts +4 -1
  129. package/server/infra/http/on-listening.ts +3 -1
  130. package/server/infra/process/psmux.ts +58 -0
  131. package/server/infra/process/tmux.ts +23 -4
  132. package/server/routes/app-routes.ts +4 -3
  133. package/server/session/project-dir.ts +39 -2
  134. package/server/session/pty/pty-spawn.ts +22 -5
  135. package/server/skills/mulmoterminal-bug-report/faq.md +2 -1
  136. package/server/skills/mulmoterminal-config/SKILL.md +25 -3
  137. package/server/skills/mulmoterminal-data-analysis/SKILL.md +99 -20
  138. package/dist/assets/channel-AVSAFTyU.js +0 -1
  139. package/dist/assets/dist-B2oJvzYm.js +0 -9
  140. package/dist/assets/dist-Buocvpeu.js +0 -11
  141. package/dist/assets/dist-CSl__cQ2.js +0 -2
  142. package/dist/assets/flowDiagram-IUGLLWBU-CRjonzqN.js +0 -1
  143. package/dist/assets/index-BhBIMUl6.css +0 -1
  144. package/dist/assets/swimlanesDiagram-AYQRV4AK-CZ1Tzy0M.js +0 -8
package/README.md CHANGED
@@ -50,6 +50,13 @@ That is the whole install.
50
50
 
51
51
  </details>
52
52
 
53
+ [![MulmoTerminal, the complete guide - a chaptered walkthrough on YouTube](https://img.youtube.com/vi/Ce8XvlLRpQ4/maxresdefault.jpg)](https://www.youtube.com/watch?v=Ce8XvlLRpQ4)
54
+
55
+ *The complete guide, Parts 1-5 — getting started, making it your workspace, agents that hand you
56
+ a screen, power features (seven agents at once, several subscriptions, shortcuts), and going
57
+ further into cells that talk to each other, git worktrees and the command palette. Chaptered, so
58
+ you can jump to the part you need.*
59
+
53
60
  MulmoTerminal turns [Claude Code](https://claude.com/claude-code) — and six other agent CLIs —
54
61
  into a parallel, observable workspace: many agent sessions at once in a grid, each one
55
62
  color-coded so you see at a glance which are **working**, which **need you**, and which are
@@ -293,7 +300,7 @@ Needs **Node ≥ 22.12**, plus these CLIs — on your `PATH`, or named by the ma
293
300
  | **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) |
294
301
  | **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` |
295
302
  | Optional | `glab` | the same for **GitLab** projects (#981) — gitlab.com, and a self-hosted instance you declare in `gitlabHosts` (#1332). Same arrangement: the CLI holds the credentials, this app stores no token | `brew install glab`, then `glab auth login` (self-hosted: `glab auth login --hostname gitlab.example.com`) |
296
- | Recommended | `tmux` — the **latest release** (3.8 as of 2026-10-10); older ones are not supported | [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) |
303
+ | Recommended | `tmux` — the **latest release** (3.8 as of 2026-10-10); older ones are not supported | [session persistence](#session-persistence-tmux) — terminals survive a server restart | `brew install tmux` · `sudo apt install tmux` · `sudo dnf install tmux` · Windows: `winget install -e --id marlocarlo.psmux` (3.4.0+, see [psmux on Windows](#psmux-on-windows)) |
297
304
  | Optional | any other agent CLI | a cell can run **Codex**, **Antigravity** (`agy`), **Grok**, **Muse**, **GitHub Copilot CLI** or **Cursor CLI** instead of Claude — install only the ones you use, and a missing one simply fails to start that cell. What each can do is [the capability matrix](docs/agent-capability-matrix.md); how to install and pick one is the [agents guide](https://receptron.github.io/mulmoterminal/guide/en/agents.html) | e.g. `npm i -g @openai/codex` |
298
305
  | 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` |
299
306
  | Optional | `remotion` packages | MulmoCast's `remotion` beats, where Claude Code writes each scene as a Remotion component (mulmocast 2.13.0). Not a dependency of this app: install them yourself, into your home directory so an `npx` upgrade does not lose them — `init` reports whether mulmocast can see them | [Remotion scenes](https://receptron.github.io/mulmoterminal/guide/en/mulmocast.html#remotion) · [日本語](https://receptron.github.io/mulmoterminal/guide/ja/mulmocast.html#remotion) |
@@ -708,9 +715,36 @@ things MulmoTerminal asks tmux for, such as restoring bracketed paste after a re
708
715
  newer. A distribution's package is often older, so check `tmux -V` and take a newer build from
709
716
  [tmux releases](https://github.com/tmux/tmux/releases) when it is.
710
717
 
711
- On Windows there's no native tmux, so sessions use the non-persistent fallback — run the
712
- server under **WSL** if you want persistence. Nothing else is required: MulmoTerminal
713
- detects `tmux` on `PATH` at startup and uses it automatically when present.
718
+ Nothing else is required: MulmoTerminal detects `tmux` on `PATH` at startup and uses it
719
+ automatically when present.
720
+
721
+ #### psmux on Windows
722
+
723
+ Windows has no native tmux. [psmux](https://github.com/psmux/psmux), a native Windows
724
+ tmux, gives the same persistence — sessions survive a server restart, a crash and **Quit**, and
725
+ come back on the next start:
726
+
727
+ ```powershell
728
+ winget install -e --id marlocarlo.psmux # installs itself as tmux.exe
729
+ tmux -V # second line: psmux 3.4.0 or newer
730
+ ```
731
+
732
+ Then restart MulmoTerminal; the server log says `[tmux] running on psmux <version>`. Use **psmux
733
+ 3.4.0 or newer**: older releases drop an auto-run prompt's Enter into the paste (the prompt is
734
+ typed but never sent) and lose a double Esc, and the server warns at startup when it finds one.
735
+ What MulmoTerminal does differently behind psmux, and only there:
736
+
737
+ - starts each psmux client with `PSMUX_VT_INPUT=1`, so a paste keeps its markers and the Enter
738
+ after it is not taken into it. `PSMUX_VT_INPUT=0` in the server's environment turns this off;
739
+ - counts emoji two cells wide in the browser (Unicode 11), as Claude Code and psmux do — otherwise
740
+ each emoji shifts the rest of its row by one column;
741
+ - keeps Volta's `_VOLTA_TOOL_RECURSION` out of psmux's environment, so `node` in a cell resolves through
742
+ Volta's shim again.
743
+
744
+ psmux imitates tmux 3.4, so the few things that need tmux 3.7+ (such as restoring bracketed paste
745
+ after a reload) are not available on it. A Windows restart still ends every session, as a reboot
746
+ does with tmux. Without psmux nothing changes: sessions use the non-persistent fallback, or run the
747
+ server under **WSL**.
714
748
 
715
749
  ---
716
750
 
@@ -847,6 +881,8 @@ The Settings modal (the gear button) persists per-user UI choices to `~/.mulmote
847
881
  | `appendSystemPrompt` | Whether a spawned Claude session is asked to end a reply with a **closing summary** — what was asked, what was achieved, what was not (see [Closing summary](#closing-summary)). **On by default**; set `false` to opt out, and a directory's `.mulmoterminal.json` outranks this. Settings → **Sessions and background tasks** has the switch. Read per spawn, so no restart is needed, though a session already running keeps what it was launched with. `true` / `false` only. |
848
882
  | `autoDirIcon` | Whether a project that sets no `icon` shows the favicon its repository already ships (`public/favicon.svg`, `apple-touch-icon.png`, a web manifest — first hit wins, ordered by how the image survives at 14px). **On by default**; Settings → **Directory appearance** has the switch. A single project opts out with `"icon": false` in its own `.mulmoterminal.json`, which this does not override. A key that was written and got it wrong shows nothing rather than falling back — a broken setting has to look broken. `true` / `false` only. |
849
883
  | `cockpitLines` | `{ summary, prompt, response }` — how many lines each **cockpit-roster** row shows before it clamps (default `2` / `2` / `3`, each clamped to `1`–`20`). Raising them trades how many sessions fit on screen for reading a long one in place. Three steppers in Settings → **Waiting rows**. |
884
+ | `usageGauge` | Whether the grid header draws the 5h / 7d **usage gauge** for Claude and Codex. Claude is measured by a hidden `claude` making one API call, which counts against those windows. **On by default**; `false` hides the gauge and measures nothing. Settings → **Grid header read-outs** has the switch. |
885
+ | `usageProbeIntervalMinutes` | How many minutes Claude's reading may age before the gauge measures it again. **Default `10`**, whole minutes from 2 to 60. Settings → **Grid header read-outs** has the stepper. |
850
886
  | `showLoadAverage` | Whether the grid header draws this machine's **load average** beside the 5h / 7d usage windows, as a percentage of its cores (`load 334%` = a 20-core machine with 66.8 runnable processes). **On by default**; amber at 100%, red at 200%, hover for the raw 1 / 5 / 15-minute figures. Settings → **Grid header read-outs** has the switch. A host that keeps no load average (Windows) shows nothing rather than `0%`, whatever this says. `true` / `false` only. |
851
887
  | `remoteServer` | **Experimental.** The server runs on another machine than your browser (an SSH tunnel — [guide](https://receptron.github.io/mulmoterminal/guide/en/remote.html)): the actions that would act on the server's screen (the file dialog, the file manager, the OS app) are hidden or say why, and a dropped file is always uploaded. **Off unless `true`**; Settings → **Sessions and background tasks** has the box (or set it in the server's config). |
852
888
  | `fontFamily` | The **terminal font** every session renders in — a CSS font-family stack, e.g. `"'Cica', 'MS Gothic', monospace"`. Set it in Settings → **Terminal font**, applied at once; editing the file instead needs a **restart** (this config is read once at startup). Unset uses the built-in stack (JetBrains Mono / Fira Code / Menlo / Consolas, then CJK faces for Japanese, Korean and Chinese). Unlike the per-browser font **size**, this is one value for the whole host — it names fonts, and which fonts exist is a property of the machine. A directory can override it. See the [Configuration guide](https://receptron.github.io/mulmoterminal/guide/en/config.html#font-family). |
@@ -1313,7 +1349,9 @@ tree; clicking a file opens it in a **CodeMirror** editor (Markdown / JS-TS / JS
1313
1349
  highlighting, everything else as plain text). Markdown files get a **Preview** toggle
1314
1350
  that renders via the server's sandboxed `…/md` HTML, with a ` ```mermaid ` fence drawn as a diagram
1315
1351
  (its code block stays under it, folded, so the copy button is still there); a `.csv` / `.tsv` previews as a table (the
1316
- same `…/table` document a clicked path opens, in the app's colours), and an `.html` / `.svg` as the
1352
+ same `…/table` document a clicked path opens, in the app's colours), a `.json` as indented JSON (the
1353
+ `…/json` document, likewise; only a `.json` whose top level has a `$mulmocast` key is offered the
1354
+ **Canvas** view as a MulmoScript), and an `.html` / `.svg` as the
1317
1355
  page or picture it is. **Save** (or ⌘/Ctrl-S) writes back. **History** lists the versions the pane
1318
1356
  kept of the file (in `~/.mulmoterminal/backups`, taken when it is opened or reloaded here and before a save
1319
1357
  here replaces it — the newest few), to compare with the buffer or restore as an undoable edit (unsaved edits
@@ -149,7 +149,12 @@ const PATH_TOOLS = [
149
149
  why: "the PRs & Issues view for gitlab.com projects",
150
150
  hint: "brew install glab (then: glab auth login)",
151
151
  },
152
- { cmd: "tmux", required: false, why: "sessions survive a restart", hint: "brew install tmux · apt install tmux" },
152
+ {
153
+ cmd: "tmux",
154
+ required: false,
155
+ why: "sessions survive a restart",
156
+ hint: "brew install tmux · apt install tmux · Windows: winget install -e --id marlocarlo.psmux",
157
+ },
153
158
  { cmd: "codex", required: false, why: "run OpenAI Codex as an agent", hint: "npm install -g @openai/codex" },
154
159
  {
155
160
  cmd: "ffmpeg",
@@ -68,4 +68,4 @@ export const isGitlabHost = (host: string, declared: readonly string[]): boolean
68
68
  * feature was coming, or what to try — so the reason has to carry the fix.
69
69
  */
70
70
  export const unknownForgeReason = (host: string): string =>
71
- `${host} is not supported yet — MulmoTerminal reads github.com and gitlab.com; if ${host} is a self-hosted GitLab, add it to "gitlabHosts" in ~/.mulmoterminal/config.json and restart`;
71
+ `${host} is not supported yet — MulmoTerminal reads github.com and gitlab.com; if ${host} is a self-hosted GitLab, add it in Settings → GitHub and GitLab, or to "gitlabHosts" in ~/.mulmoterminal/config.json and press Reload config file`;
@@ -0,0 +1,13 @@
1
+ // Which Unicode width table the browser's xterm counts cells with. xterm's default is "6", where an
2
+ // emoji such as `✅` is one cell; Claude Code and psmux count it as two. psmux repaints only the
3
+ // cells it thinks changed, so on it every emoji shifts the rest of its row one column — "11"
4
+ // agrees with them. A real tmux keeps xterm's default, which is what it has always run on.
5
+ export const TERMINAL_UNICODE_VERSIONS = ["6", "11"] as const;
6
+
7
+ export type TerminalUnicodeVersion = (typeof TERMINAL_UNICODE_VERSIONS)[number];
8
+
9
+ export const DEFAULT_TERMINAL_UNICODE_VERSION: TerminalUnicodeVersion = "6";
10
+
11
+ export const isTerminalUnicodeVersion = (value: unknown): value is TerminalUnicodeVersion => TERMINAL_UNICODE_VERSIONS.some((version) => version === value);
12
+
13
+ export const terminalUnicodeVersionFor = (psmux: boolean): TerminalUnicodeVersion => (psmux ? "11" : DEFAULT_TERMINAL_UNICODE_VERSION);
@@ -0,0 +1,23 @@
1
+ // The usage gauge's two settings (#3153). Both sides decide from them — the server sanitizes what the
2
+ // config file says and gates its probe on it, the browser hydrates the toolbar and the Settings
3
+ // stepper — so a default or a bound that disagreed across the two would show a control that does not
4
+ // match what the server does.
5
+
6
+ /** ON unless the config says otherwise: the gauge is what most users open the grid to see. */
7
+ export const USAGE_GAUGE_DEFAULT = true;
8
+
9
+ export const sanitizeUsageGauge = (input: unknown): boolean => (typeof input === "boolean" ? input : USAGE_GAUGE_DEFAULT);
10
+
11
+ // How old Claude's reading may be before a probe is spent on a new one, in minutes.
12
+ export const DEFAULT_USAGE_PROBE_INTERVAL_MINUTES = 10;
13
+ // The browser asks every two minutes, so a shorter interval would not measure any more often.
14
+ export const MIN_USAGE_PROBE_INTERVAL_MINUTES = 2;
15
+ // The gauge stops drawing a reading an hour old (CLAUDE_READING_MAX_AGE_MS), so a longer interval
16
+ // would leave the Claude half blank between probes.
17
+ export const MAX_USAGE_PROBE_INTERVAL_MINUTES = 60;
18
+
19
+ /** Whole minutes, clamped to [MIN, MAX]. Anything that is not a positive number is the default. */
20
+ export function sanitizeUsageProbeIntervalMinutes(input: unknown): number {
21
+ if (typeof input !== "number" || !Number.isFinite(input) || input <= 0) return DEFAULT_USAGE_PROBE_INTERVAL_MINUTES;
22
+ return Math.min(MAX_USAGE_PROBE_INTERVAL_MINUTES, Math.max(MIN_USAGE_PROBE_INTERVAL_MINUTES, Math.round(input)));
23
+ }
@@ -1 +1 @@
1
- import{m as e,t}from"./mermaid-parser.core-CNDAB8o0.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-JH1jZ6Eh.js";import"./chunk-DSNLSHJZ-JVf11DZn.js";import{n as i,r as a,t as o}from"./chunk-2E7WHVMD-D7xIRLSq.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-CoL-f9aD.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(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=n(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=n(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=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
1
+ import{m as e,t}from"./mermaid-parser.core-C61BrrC3.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-JH1jZ6Eh.js";import"./chunk-DSNLSHJZ-DK1kK-FT.js";import{n as i,r as a,t as o}from"./chunk-2E7WHVMD-BetO9SrX.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-Cl24-ZEG.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(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=n(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=n(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=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
@@ -1 +1 @@
1
- import"./chunk-NGNAAXSQ-C2Wy9Xmz.js";export{M as createArchitectureServices}from"./mermaid-parser.core-CNDAB8o0.js";
1
+ import"./chunk-NGNAAXSQ-C2Wy9Xmz.js";export{M as createArchitectureServices}from"./mermaid-parser.core-C61BrrC3.js";