fm
Reviewed
at commit c6b6232
Firstmate Calm for Claude Code: the sailboat working animation and conversation-only transcript presentation, sharing the per-home config/calm preference with…
0 upvotes
Log in to upvote or save- Made by
- Firstmate
- Pinned commit
-
c6b62326735593017ce8d25779eca7ece21085aa - What we checked
-
Companion display mod for the Firstmate project, off until you type /calm. While Calm is on, the spinner becomes an animated sailboat, and tool calls, results, short notes from Claude and Firstmate's automatic messages are hidden on screen; what Claude sees and the transcript stay unchanged. It adds dim lines with Firstmate updates from its local state files, reads and writes only small files in that folder, runs no programs and makes no network calls.
Review details
Static review of the source at the pinned commit; not run. Delta review of the changes since 40e981d; the rest carries over from the review at that commit. The only plugin change is one line in hooks/register.ts: the sailboat Box in the Spinner render gets paddingTop: 1 (a blank row above the boat) plus a comment; the other changed files are tests. No new calls, files, hosts or programs. Carried over: hooks/hooks.json loads hooks/register.ts, which imports lib/fm-calm-working-ship-sprite.ts, lib/fm-calm-ship-raster.ts, lib/fm-calm-presentation.ts (which imports lib/fm-operational-input.ts and lib/fm-calm-preservation.ts) and lib/fm-branch-notes.ts. Every handler first checks $.env.get('CLAUDE_CODE_ENABLE_FUNCTION_HOOKS') === '1' and otherwise just calls next(e). Hooks: session.start, command.run (calm), config.set (theme), turn.step, and ui.render for Spinner, ToolUse, ToolResult, ToolGroup, UserMessage and AssistantMessage. session.start registers /calm and starts the supervision notes: it resolves the Firstmate home from FM_HOME, FM_ROOT_OVERRIDE or three folders above $.plugin.root and reads state/.branch-outcomes-tail.jsonl, .branch-outcomes-cursor, .branch-outcomes-processed and .supervision-host-health via $.fs. A 3 s $.clock.every poll appends new lines with $.ui.log, and $.store keeps the last shown sequence for up to 20 sessions. /calm writes 'on' or 'off' to <home>/config/calm with $.fs.write and shows a toast. turn.step passes the model stream through unchanged. While Calm is on, ui.render hides tool rows, recorded working notes and Firstmate operational user rows; for a 'doorbell' row it reads the named .msg file inside an operational-inbox folder only to classify it. The Spinner is replaced by a Raster sailboat repainted with $.ui.blit on a 220 ms ticker. No network calls, no programs, no eval, no obfuscated code.
- What it uses
-
- Reads your prompts: yes
- Sees tool calls: no
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: no
- Calls the model (uses tokens): no
- Sends data over the network: no
- Stores data: yes
- Shows something on screen: yes
- Hooked events
Firstmate Calm for Claude Code: the sailboat working animation and conversation-only transcript presentation, sharing the per-home config/calm preference with the Pi Calm extension. Its hooks module may load through CLAUDE_CODE_ENABLE_FUNCTION_HOOKS or Claude Code's tengu_plugin_hooks_modules rollout flag, but the mod activates only when CLAUDE_CODE_ENABLE_FUNCTION_HOOKS is exactly 1 and is otherwise a complete no-op.
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/fm/)