Commands

KOZMOS Marquee: a status-line ticker. Model and effort, context fill, 5-hour and weekly limits with the reset countdown, session cost, git branch with ahead and dirty counts, and the tool running now, refreshed every second; it scrolls like a marquee when longer than its width. /marquee toggles it.

KOZMOS Mosaic: a GitHub-style activity calendar across sessions. 26 weeks of days colored by turns, tool calls, tokens or dollars, with the current and longest streak, the best day, totals and today's line. /mosaic toggles the sidebar.

KOZMOS Orrery: subagents as planets circling a central sun above the prompt. Running agents orbit at a speed set by their tokens per second, finished ones settle into a faint outer ring, failed ones flash a red cross; a legend names up to four with type and elapsed time. /orrery toggles it.

KOZMOS Polaroid: /polaroid snapshots the session as a self-contained dark-neon HTML report in .kozmos/reports: model, duration, cost, tokens, context peak, rate limits, tool calls by family, a timeline of turns, subagents, files touched and commands run, all collected live. It answers with the path and copies it. /polaroid md writes Markdown instead.

KOZMOS Questline: task progress above the prompt. One segmented bar for the session's todos and tasks (done green, running violet and pulsing, waiting gray), the count, what is running now and for how long. Hides itself two minutes after everything is done. /questline toggles it.

KOZMOS Relay: the API latency lab in a sidebar. Every model request of the main loop and its subagents with latency, time to first token, model, effort, input/output/cache tokens, tokens per second and stop reason; a latency histogram, tokens/sec over time, model mix, p50/p95, the slowest five and cache-read share per request. /relay toggles it.

KOZMOS Resonance: a synthesized soundscape for the session. A soft tick per tool, a bonk on failures, a gong after long turns, a bell when a subagent finishes, an alarm when a rate-limit window crosses 80% or 95%, a chime on the first turn. /resonance mutes.

KOZMOS Skies: the session's weather above the prompt. Tool failures, context and rate-limit pressure, stalls and the local hour make clear skies, clouds, rain, storms with lightning, fog, a starry night, or a rainbow after a storm clears; an animated scene and a forecast line. /skies toggles it.

KOZMOS Spectra: the context X-ray. The context window broken down by category as a heat grid with a ranked legend, context growth per turn, and an estimate of how many turns remain before auto-compact. /spectra toggles the sidebar.

KOZMOS Stamp: a receipt on every finished turn. The closing 'Baked for 42s' line becomes a compact row of duration, tool calls by family as colored chips, tokens in and out, the turn's cost and the context fill with its change. /stamp toggles it.

KOZMOS Storyboard: Claude narrates its own progress. A chapter tool the model calls at each phase change drives a band above the prompt: the chapter title, a five-stage rail (explore, plan, build, verify, ship) with the active stage glowing, step 3/5 and a note. /storyboard toggles the band, /storyboard log opens the chapter history.

KOZMOS Switchboard: an MCP observatory sidebar. Every MCP server in the session with its tools, calls, errors, average and p95 latency, last call and a status lamp (healthy, erroring, idle, busy); servers with no calls yet too, and per-tool rows on expand. On the desktop a patch bay with glowing cables to the active servers. /switchboard toggles it.

KOZMOS Taskforge: a live kanban of the session's tasks. TodoWrite lists and TaskCreate/TaskUpdate tasks fall into Pending, In progress and Done columns with the active form, time in the column and the owning agent, under a progress bar. /taskforge toggles the sidebar.

KOZMOS Tempo: a Pomodoro focus timer above the prompt. A tomato, the phase, a ring (desktop) or a sizzling bar (terminal) and the time left; long breaks every fourth round, a toast at each phase end and a tally of focus rounds per day. /tempo start [work] [break], stop, skip.

KOZMOS Terminus: the session's shell history in a sidebar. Every Bash and PowerShell call of the main loop and its subagents with command, description, cwd, exit status, duration, output size and who ran it; filters for failed and slow runs, copy and re-run buttons. /terminus toggles it.

KOZMOS Thermal: a heatmap of the files this session touches. Reads, edits, writes and searches per file, a heat score that cools over time, grouped as a directory tree under the session folder: an indented heat tree on the terminal, a squarified treemap on the desktop, switchable by heat, reads or edits. /thermal toggles it.

KOZMOS Thrift: a frugal mode. /thrift on|off|auto; while on, every prompt carries a short note asking Claude to be economical (targeted reads, no broad searches or subagents unless needed, concise answers). Auto turns it on when the 5-hour or weekly limit passes autoAt and off after the window resets. A band with a spinning coin, and /thrift compares the average cost of thrift turns with...

KOZMOS Throttle: a car dashboard above the prompt. Speedometer of output tokens per second, fuel gauge of the 5-hour limit, temperature of the context, an odometer of session dollars, and check-engine, fuel and overheat lamps. /throttle toggles it.

KOZMOS Tidewater: the live diff of the current turn as tides above the prompt. Every file Claude edits gets its own pool of rolling waves, a green swell for added lines and a red ebb for removed ones, with file chips and totals like '+128 −42 · 6 files'. From the first edit of a turn until the next prompt. /tidewater toggles it.

KOZMOS Tokenomics: the cost lab. Session cost as the headline, an estimated split by model and by token type, cache hit ratio, burn per hour, cost per turn, a pace forecast and daily and weekly totals across sessions with a 14-day chart. /tokenomics toggles the sidebar.

KOZMOS Toolmarks: badges on tool rows. Each finished call gets a family-colored glyph and its duration at the row's end, Bash calls their exit status, failed calls a red mark, and a folded group its total time and failures. /toolmarks toggles them.

KOZMOS Verdict: test, build and lint results above the prompt. Spots the test runners, type checkers, linters and builds Claude runs (vitest, jest, pytest, go test, cargo, dotnet, mocha, bun, tsc, eslint, npm run build, maven, gradle…), parses pass/fail/skip and error counts, and shows chips like '✓ vitest 142 · ✗ jest 3 failed · ✓ tsc 0 errors' with a red pulse on failures and a sparkline of...

KOZMOS Vitals: a btop-style machine monitor sidebar. CPU with a braille history graph, RAM bar and history, disk use, NVIDIA GPU load, memory and temperature, process count, and the Claude side: session time, tool calls, running agents. Samples every 2 s only while open. /vitals toggles it.

KOZMOS Warden: a guard for destructive shell commands. Before Claude or a subagent runs rm -rf on a broad path, git push --force, reset --hard, clean -fd, DROP TABLE, mkfs, format, curl | sh and their kin, warden asks you (Allow once / Deny) and refuses when no one can answer. A band flashes for 8 s after a block; /warden lists the rules and this session's log.