Repository navigation
Releases
Releases · adar2378/claude-garage
1.1.2 — markdown links open
Release Notes
Fixed
- 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. Onlyhttpandhttps
links open.
Install claude-garage 1.1.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/adar2378/claude-garage/releases/download/v1.1.2/claude-garage-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/download/v1.1.2/claude-garage-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install claude-garage@1.1.2Download claude-garage 1.1.2
| File | Platform | Checksum |
|---|---|---|
| claude-garage-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| claude-garage-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| claude-garage-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| claude-garage-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| claude-garage-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
1.1.1 — the rail stays put
Release Notes
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 the1to9
keys 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.
Install claude-garage 1.1.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/adar2378/claude-garage/releases/download/v1.1.1/claude-garage-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/download/v1.1.1/claude-garage-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install claude-garage@1.1.1Download claude-garage 1.1.1
| File | Platform | Checksum |
|---|---|---|
| claude-garage-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| claude-garage-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| claude-garage-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| claude-garage-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| claude-garage-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
1.1.0 (not published, use 1.1.1)
This release failed CI and was never published to npm. It has no binaries. Use v1.1.1, which has the same changes.
1.0.3 — projects added from outside show up
Release Notes
- 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.
Install claude-garage 1.0.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/adar2378/claude-garage/releases/download/v1.0.3/claude-garage-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/download/v1.0.3/claude-garage-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install claude-garage@1.0.3Download claude-garage 1.0.3
| File | Platform | Checksum |
|---|---|---|
| claude-garage-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| claude-garage-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| claude-garage-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| claude-garage-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| claude-garage-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
1.0.2 — know which session finished
Release Notes
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 asalerts: ✓ 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.
Install claude-garage 1.0.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/adar2378/claude-garage/releases/download/v1.0.2/claude-garage-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/download/v1.0.2/claude-garage-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install claude-garage@1.0.2Download claude-garage 1.0.2
| File | Platform | Checksum |
|---|---|---|
| claude-garage-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| claude-garage-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| claude-garage-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| claude-garage-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| claude-garage-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
1.0.1 — one binary, plugins and alerts
Release Notes
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.
Added
- 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 (needsterminal-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 X
closes it and keeps it in closed chats.- garage refuses to start on tmux older than 3.2 and says how to upgrade.
Changed
- garage is now one native binary. The daemon, the TUI and the
claude-garage
command 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 byclaude-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
- The unused
GET /api/diff/:workspaceroute.
Install claude-garage 1.0.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/adar2378/claude-garage/releases/download/v1.0.1/claude-garage-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/download/v1.0.1/claude-garage-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install claude-garage@1.0.1Download claude-garage 1.0.1
| File | Platform | Checksum |
|---|---|---|
| claude-garage-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| claude-garage-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| claude-garage-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| claude-garage-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| claude-garage-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
v0.6.3 — fixes
Fixed
- 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.
v0.6.2 — parent folders lead their group
0.6.1 was tagged but never published; this is the same change.
Fixed
- A workspace at its repos' parent folder now leads their group. If
you register a folder (for exampleelite-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.
v0.3.2 — title as name + honest context meters
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.
Fixed
- 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_size
payload 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.
v0.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.
Added
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 (a
jump,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); new
GET /api/usagefor account-wide 5-hour/7-day rate-limit data.
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 (see
openspec/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.