Skip to content

Releases

1.1.2 — markdown links open

Choose a tag to compare

@github-actions github-actions released this 04 Nov 13:06

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. Only http and https
    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 | sh

Install 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.2

Download 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

Choose a tag to compare

@github-actions github-actions released this 03 Nov 21:33

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 the 1 to 9
    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 through a.
  • Reorder projects. Shift+Up and Shift+Down move 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 | sh

Install 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.1

Download 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)

Choose a tag to compare

@github-actions github-actions released this 03 Nov 21:06

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

Choose a tag to compare

@github-actions github-actions released this 02 Nov 13:18

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 | sh

Install 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.3

Download 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

Choose a tag to compare

@github-actions github-actions released this 02 Nov 11:09

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.
  • a reaches 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.

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 | sh

Install 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.2

Download 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

Choose a tag to compare

@github-actions github-actions released this 01 Nov 23:19

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 (needs terminal-notifier). Options: claude-garage alerts.
    Alerts are a bundled plugin, on by default, also when you upgrade.
  • Plugins overlay. Press p to 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 x kills 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-garage after 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.log is rotated at 10 MB when the daemon starts.
  • The built-in needs-input notification moved into the alerts plugin.
  • GARAGE_TUI_BIN is read by debug builds only.

Removed

  • The unused GET /api/diff/:workspace route.

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 | sh

Install 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.1

Download 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

Choose a tag to compare

@github-actions github-actions released this 31 Oct 15:56
8b5bb3a

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

Choose a tag to compare

@github-actions github-actions released this 25 Oct 18:48

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 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.

v0.3.2 — title as name + honest context meters

Choose a tag to compare

@adar2378 adar2378 released this 01 Sep 11:50

Changed

  • The title is the name now (TUI). claude-1 means 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 own context_window.context_window_size
    payload field, which wins over every heuristic. (The statusline-fed
    percentage — the I install — was always correct; only the fallback
    was wrong.)
  • npm run build:tui no 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

Choose a tag to compare

@adar2378 adar2378 released this 01 Sep 08:40

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, A queue overlay), frozen local scrollback, and a ? help overlay.
    Ships as a prebuilt arm64 binary on macOS; other platforms self-build
    once via cargo on first run.
  • Views (groups): partition a workspace's sessions into named views —
    d detaches the focused session into its own view or rejoins it to the
    default, D moves it to a chosen group, Tab cycles 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 by a/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-day usage chip, fed by a one-keypress I install of a chaining
    statusline wrapper in ~/.claude/settings.json (any statusline you
    already have keeps running via a POST /api/statusline/claude daemon
    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: Enter restores a dead
    (restorable) session, x x discards one; R restores 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/health now
    reports {version, pid}), and — in a source checkout — rebuilds a wall
    binary that's older than wall/src.
  • Daemon API: session entries gain message (the triggering
    Notification hook's text while needs-input), title (the live pane
    title), and context ({ usedPercentage, source }, or null); new
    GET /api/usage for account-wide 5-hour/7-day rate-limit data.

Changed

  • claude-garage tui previously 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.