Changelog
1.1.2 — markdown links open
Section titled “1.1.2 — markdown links open”- Links that show as text now open on click inside the wall. Claude Code
writes markdown links as a label with the address hidden behind it, and
clicking the label did nothing; only addresses printed in full worked.
The wall now keeps the hidden address and opens it. Only
httpandhttpslinks open.
1.1.1 — the rail stays put
Section titled “1.1.1 — the rail stays put”Changed
Section titled “Changed”- The rail no longer reorders itself. A session that needs you used to
float its project, and its whole folder group, to the top, so the
1to9keys pointed at different projects from one minute to the next. Projects and sessions now keep their place. A waiting session still shows in amber, with the count on its project, in the strip total and througha. - Reorder projects.
Shift+UpandShift+Downmove the focused project up or down the rail. The order is saved and survives a restart. The head of a folder group stays first in its group, and moving it moves the whole group. - Renaming a project keeps its place. It used to move to the end of the rail.
1.0.3 — projects added from outside show up
Section titled “1.0.3 — projects added from outside show up”- A project added from outside the wall (by an agent, a script or
claude-garage open) now shows up at once, and one removed from outside disappears. A rename shows up at once too.
1.0.2 — know which session finished
Section titled “1.0.2 — know which session finished”Changed
Section titled “Changed”- Finished sessions you have not seen. A session that finishes while you look at another one gets a green bar and a green check in the rail, and its workspace gets a green dot. They clear when you focus the session. A finished session you have seen goes dim at once instead of after two minutes.
areaches finished sessions. It still jumps to the session that has waited longest. When none waits, it jumps to the newest finished one you have not seen.- The footer names every alert. When an alert plays, the footer shows
which session it is for, such as
alerts: ✓ web · fix login finished · a to jump, also when garage is in view and no banner shows. - Fewer false “finished” chimes. A finished chime now waits 8 seconds and is dropped if the session went back to work. “Needs you” is not delayed.
- Rail. Working sessions are dim, so only sessions that need you or finished unseen stand out. Workspace names are bold, and a blank row separates workspaces when the rail is tall enough.
- A row that starts waiting for you flashes once when motion is on.
1.0.1 — one binary, plugins and alerts
Section titled “1.0.1 — one binary, plugins and alerts”The first stable release. (The 1.0.0 tag stopped in CI before any binary
was built; 1.0.1 is the same release with a test fix.) npx claude-garage installs it; the shell and
PowerShell installers are on the GitHub release. There is no Homebrew
formula yet. Windows (x64) has a prebuilt binary and is still a preview: it
has not been tested on real Windows yet.
- Alerts. A chime when a session needs you, and a softer one when a
session finishes a turn that took 20 seconds or more. When garage is not
the focused window you also get a desktop banner with Claude’s question.
On macOS, clicking the banner brings your terminal forward and jumps to
that session (needs
terminal-notifier). Options:claude-garage alerts. Alerts are a bundled plugin, on by default, also when you upgrade. - Plugins overlay. Press
pto see every plugin, where it came from and what it may do, and turn it on or off with Space. Changes apply at once. - Status colours in the rail. A working session has a cyan spinning glyph and a bright name, a fresh done session is green, and sessions in other views keep their colours.
x xkills the focused session with no history (as in 0.6.x);x Xcloses it and keeps it in closed chats.- garage refuses to start on tmux older than 3.2 and says how to upgrade.
Changed
Section titled “Changed”- garage is now one native binary. The daemon, the TUI and the
claude-garagecommand are a single Rust program: no Node at runtime, and nothing else to download. Your sessions are untouched: tmux still owns them. - Install with whichever you like.
npx claude-garage, or a shell or PowerShell installer. macOS (Apple silicon and Intel), Linux (x64 and arm64) and Windows (x64) get prebuilt binaries. Windows is a preview. - Upgrading from 0.6.x is automatic. The first
claude-garageafter the upgrade notices the old daemon, stops only that process, and starts the new one. No session is closed. - The bundled plugins ship inside the binary, and each plugin’s files are
checked against the hashes of that build before every start, by the daemon
and by
claude-garage <plugin command>. A plugin binary that was damaged or replaced on disk is refused; restarting the daemon puts the shipped files back. This guards against accidental damage, not against someone who already runs code as you. Unpacked sets are keyed by the build, and one is removed only after a week without use. All first-party plugins, including on Windows, ship in the binary. - The bottom strip no longer repeats the workspace list; the rail has it.
- Closing a tile is instant, with no exit animation.
daemon.logis rotated at 10 MB when the daemon starts.- The built-in needs-input notification moved into the alerts plugin.
GARAGE_TUI_BINis read by debug builds only.
Removed
Section titled “Removed”- The unused
GET /api/diff/:workspaceroute.
0.6.3 — fixes
Section titled “0.6.3 — fixes”- Sessions in folders with a dot in the path now show their context.
Worktrees live under
~/.garage, and their transcripts were never found, so the context meter stayed empty. - Restarting a session no longer makes it disappear when Claude has no conversation to resume. The session is created again instead of failing.
- Finishing a worktree can no longer delete the wrong folder. Discard and merge now check the folder is inside the garage worktrees folder, and merge also checks it is on the expected branch; nothing is deleted if not. Discard still works if the agent switched branches.
0.6.2 — parent folders lead their group
Section titled “0.6.2 — parent folders lead their group”0.6.1 was tagged but never published; this is the same change.
- A workspace at its repos’ parent folder now leads their group. If
you register a folder (for example
elite-traders) and also the repos inside it (et-backend,et-admin), the folder’s workspace now sits at the top of that group instead of with its own neighbours. The label row shows the folder’s name. Folder case is still ignored. - A workspace with a session waiting on you still comes first inside its group, above the folder’s workspace.
0.6.0 — folder groups in the rail
Section titled “0.6.0 — folder groups in the rail”- Sibling workspaces sit together. Workspaces that live in the same
parent folder are now adjacent in the rail, with a faint label row
naming the folder (for example
elite-traders) above the first one. Folder case is ignored. Workspaces with no sibling get no label. - Blocked work floats as a family. If any workspace in a folder has a session waiting on you, the whole folder moves up, and the blocked workspace comes first inside it.
Workspace numbers 1-9 are unchanged. Label rows have no number and
clicking one does nothing.
0.5.0 — terminal only
Section titled “0.5.0 — terminal only”Breaking
Section titled “Breaking”- The web wall is gone. garage is now a terminal app.
npx claude-garagewith no subcommand opens the TUI;tuistill works as an alias. The daemon no longer serves a page onhttp://127.0.0.1:4747or terminal WebSockets on/term. Its HTTP API is unchanged. - Diff review is unavailable until it lands in the TUI (on the roadmap). The daemon’s diff API stays in place for it.
- Clicking a macOS notification no longer opens a browser tab.
- Finish a worktree from the TUI. Closing a worktree session (
x x, live or restorable) opens an overlay:mmerges the branch into the branch checked out in the repo (shown in the prompt),d ddiscards it,korEsckeeps it. A dirty worktree or a merge conflict shows inline, and the overlay stays open so you can retry or keep. Iinstalls hooks too. One key now installs the Claude Code hooks (instant status) and the statusline (context meter), with one notice that covers both, including “already installed”.
- A failed merge is aborted. When finishing a worktree hits a
conflict, the daemon runs
git merge --abort, so the repo is never left mid-merge.
Removed
Section titled “Removed”- The React web wall (
ui/), the/termWebSocket bridge, static file serving and the Vite dev origins. - Dependencies
@fastify/static,node-pty,wsandconcurrently, plus thedev,postinstallandprepackscripts.
0.4.1 — no more typing paths
Section titled “0.4.1 — no more typing paths”- Paste a path into the TUI’s add-workspace field. In the
woverlay, a paste now lands in the field instead of being dropped. Dragging a folder from Finder into Ghostty works too: the text is cleaned of shell escaping (My\ Proj→My Proj), wrapping quotes and extra lines. Pastes anywhere else outside a tile are still swallowed, so pasted text can never fire wall commands. Ctrl+Oopens the native folder picker from thewoverlay, reusing the daemon’sPOST /api/pick-directory(macOS). The picked folder fills the field; cancel keeps what you typed; a non-macOS daemon shows an inline “type or paste a path” hint. The footer now readsEnter add · ^O browse · Esc cancel.
0.4.0 — restart
Section titled “0.4.0 — restart”claude-garage restart/--sessions/--all. Restarts the daemon in place (health pid, lsof fallback, wait for health, print the version);--sessionsadditionally respawns every idle/done session’s tmux pane withclaude --resume, printing one line per restarted, skipped and failed session;--allincludes busy sessions.POST /api/daemon/restart. Self-replace: spawns a detached successor daemon with the same environment, replies 202 with its pid, then closes and exits; the successor waits for the old pid’s port to free before listening.POST /api/sessions/restart.{id}or{all: true, force?}respawns each target’s tmux pane withclaude --resume <id>in place, skippingworking/needs-inputsessions unlessforce. Returns{restarted: [{id, resumed}], skipped: [{id, status}], failed: [{id, error}]}.- TUI chords.
r rrestarts the focused session (armed double-press, warns and forces on a busy session),r arestarts every idle/done session in the focused workspace,r drestarts the daemon; all three show a strip notice and are listed in?. - Web wall control. A restart button (
↻) in the session cell’s hover controls, with the same armed double-click as close.
- The pit pet comes to the TUI. Arthur, Papito and Segan now live in
the bottom strip as one-row sprites with the same derived moods as the
web wall (sleeping, watching, alert-with-
!, boxed when the daemon drops, celebrating when the last blocked session clears) and the same manners (the cat ignores you, the duck never blinks, the pup does zoomies).Pcycles the roster; the choice persists inwall.json; clicking an alert pet is theajump, clicking it otherwise pets it. - Pets talk. Every few minutes, in character, the strip shows a line from the pet: hydrate, stretch, encouragement, a proud word when you clear the queue, a late-night nudge, a heads-up when a usage window runs hot, and a greeting when the daemon comes back. Chatter yields to anything that matters: never while a session needs input, never over a real notice, never inside a tile. Off with the pet; no separate toggle.
- Option+Enter works inside garage sessions again. 0.3.3’s tmux
extended-keys config made tmux re-encode Option+Enter as
ESC[27;3;13~, which Claude Code doesn’t parse. The daemon now also setsextended-keys-format csi-u, so modified Enter reaches Claude Code in the kitty form it already understands (tmux ≥ 3.5). Applies to the TUI, the web wall, and plaintmux attachalike. - Terminal.app note. macOS Terminal speaks neither the kitty keyboard
protocol nor modifyOtherKeys, so Shift+Enter can’t reach Claude Code
through the wall there. Use Ghostty, iTerm2, kitty or WezTerm, or add a
Terminal.app key mapping for Shift+Return that sends
\033[13;2u.
- Claude Code’s own keybindings now work in the TUI. Shift+Enter
(insert newline) reaches Claude Code instead of submitting: the wall
speaks the kitty keyboard protocol to your terminal (when it supports
it), encodes modified Enter as CSI-u (
ESC[13;2u), and the daemon applies Claude Code’s documented tmux config (extended-keys on+terminal-features 'xterm*:extkeys') idempotently at boot and on every session spawn — which also fixes Shift+Enter for plaintmux attachusers of garage sessions. Ctrl+Enter passes through too; Option+Enter,\+Enter, and Ctrl+J always worked. - Clicking a URL in a tile opens it. The wall’s mouse capture meant
your terminal’s own Cmd+click linkifier never saw clicks; now a left
click on an
http(s)://URL in any tile’s text (live or frozen) opens it via macOSopenwith a notice, without engaging the tile.
Changed
Section titled “Changed”- The title is the name now (TUI).
claude-1means nothing to a user; when Claude Code broadcasts what a session is about (“George employment history”), that title renders as the session’s primary name in the tile bar, workspace rail, and triage queue — with the auto-label demoted to a dim trailing id in the tile bar. No title → the label renders exactly as before.
- Context meters no longer overstate usage ~5× on current models. The
transcript fallback assumed a 200k context window unless the model id
carried the old
[1m]beta marker — but the Claude 5 family and the 4.6+ generation are natively 1M and their ids carry no marker, so a session at ~5% showed ~27%. The default window is now 1M, with a known-200k list (Haiku, the 3.x family, pre-4.6 Opus/Sonnet). Better still: statusline posts now teach the daemon each model’s actual window from Claude Code’s owncontext_window.context_window_sizepayload field, which wins over every heuristic. (The statusline-fed percentage — theIinstall — was always correct; only the fallback was wrong.) npm run build:tuino longer produces a binary macOS refuses to run. Copying over the dist binary’s existing inode while a running TUI still had it mapped made arm64 macOS SIGKILL every fresh exec of the file; the script now removes the old binary before copying.
0.3.0 — the TUI arc
Section titled “0.3.0 — the TUI arc”A full-screen terminal wall joins the browser wall as a second, first-class surface — same daemon, same tmux sessions, no lock-in either way.
claude-garage tui: a full-screen terminal wall (Rust/ratatui, pinned published crates — no vendored forks). Workspace rail, a live 6-tile grid with overflow rail, three-layer key routing (garage / engaged / overlay) with verbatim byte-exact key passthrough (Alt+arrows, paste, everything — the bug the browser terminal has always had), needs-input triage (ajump,Aqueue overlay), frozen local scrollback, and a?help overlay. Ships as a prebuiltarm64binary on macOS; other platforms self-build once viacargoon first run.- Views (groups): partition a workspace’s sessions into named views —
ddetaches the focused session into its own view or rejoins it to the default,Dmoves it to a chosen group,Tabcycles views. A view strip appears once a workspace has 2+ views; the 6-tile cap applies per view; blocked sessions in background views still light the rail/badge and are still reachable bya/queue jumps. Assignments persist locally (~/.garage/wall.json). - Auto-subtitles: Claude Code’s own terminal-title updates (tmux’s
#{pane_title}) surface as a dim, zero-config subtitle under each session’s label, in the tile bar and the triage queue. - Context meters: a per-tile context-usage meter and a strip-level
5h/7-dayusage chip, fed by a one-keypressIinstall of a chaining statusline wrapper in~/.claude/settings.json(any statusline you already have keeps running via aPOST /api/statusline/claudedaemon ingest endpoint) or, lazily, by tailing a session’s transcript when no statusline data has arrived yet. t— standalone terminal window: pop the focused live session into its own OS terminal window (iTerm2, else Terminal.app) alongside the wall’s own tmux client — a second attach client, nothing detaches.- Restore/close lifecycle in the TUI:
Enterrestores a dead (restorable) session,x xdiscards one;Rrestores every restorable session in a workspace; closing a worktree session always keeps its branch and points you at the web wall’s merge/discard/keep flow (that finish modal stays web-only for now). - Stale-daemon and stale-binary gates: the launcher detects and swaps a
daemon left running from a previous version (
GET /api/healthnow reports{version, pid}), and — in a source checkout — rebuilds a wall binary that’s older thanwall/src. - Daemon API: session entries gain
message(the triggering Notification hook’s text while needs-input),title(the live pane title), andcontext({ usedPercentage, source }, ornull); newGET /api/usagefor account-wide 5-hour/7-day rate-limit data.
Changed
Section titled “Changed”claude-garage tuipreviously ran on a vendored Dart/nocterm fork (nine patches deep, upstream path closed); it’s now the Rust/ratatui binary described above — same behavior, ~5× less CPU, ~8× less memory, and a 3.7× smaller binary (seeopenspec/changes/archive/2026-08-31-p9-ratatui-port/verification.md: ~5ms input latency, ~2% CPU, 2.4MB binary). The Dart TUI and the nocterm fork are removed from the build.
0.2.x — the web wall era
Section titled “0.2.x — the web wall era”The original arc, all in the browser: the terminal bridge and session
lifecycle over tmux; the pit wall (workspace grid, needs-input triage,
macOS notifications); diff review, review mode, and the VS Code jump;
reboot-survives-you restore and npx claude-garage packaging; then
worktree sessions, themes, the pit pet, and a VS Code-style dockable grid.
See git log for the full history.