Skip to content

Install on macOS, Linux and Windows

To install claude-garage, run npx claude-garage. You need tmux 3.2 or newer (macOS and Linux), Claude Code on your PATH, and Node.js 20 or newer for npx only. The shell and PowerShell installers need no Node.

Verified on claude-garage 1.0.1: the commands, requirements and messages on this page were checked against that version’s source on 2026-11-02. The Windows preview has not yet been run on real Windows.

What do I need before I install claude-garage?

Section titled “What do I need before I install claude-garage?”
Requirement Needed for Check it with
macOS or Linux (x64 or arm64). Windows x64 is a preview. Everything uname -sm
Claude Code on your PATH Every session runs claude claude --version
tmux 3.2 or newer macOS and Linux. Windows does not use tmux. tmux -V
Node.js 20 or newer Only the npx method node --version

See Platforms for how sessions run on each operating system.

  1. Pick one install method. Each one downloads a prebuilt binary. Nothing is compiled.

    Run it with npx:

    Terminal window
    npx claude-garage

    Or use the shell installer (macOS and Linux):

    Terminal window
    curl --proto '=https' --tlsv1.2 -LsSf \
    https://github.com/adar2378/claude-garage/releases/latest/download/claude-garage-installer.sh | sh

    It prints claude-garage installed. Run claude-garage (needs tmux and the claude CLI on PATH). when it is done. Read the security note first if you want to inspect the script.

    Or use the PowerShell installer (Windows preview):

    Terminal window
    powershell -ExecutionPolicy Bypass -c "irm https://github.com/adar2378/claude-garage/releases/latest/download/claude-garage-installer.ps1 | iex"
  2. Make sure tmux is installed. On macOS, claude-garage offers to run brew install tmux for you. It asks first. On Linux, install it yourself:

    Terminal window
    sudo apt install tmux

    Use dnf install tmux or pacman -S tmux on other distributions.

  3. Start the wall:

    Terminal window
    claude-garage

    The shell installer puts the binary in ~/.local/bin. Add that folder to your PATH if the command is not found.

The first launch checks for tmux and claude. If one is missing, claude-garage prints what to install and stops.

Then claude-garage starts its background daemon and opens the wall. With no projects yet, the wall shows a short message: press w to add one. Go on with Your first wall, or try the wall in your browser first.

The daemon is a small background program. It starts and watches your Claude sessions. claude-garage starts it for you, and it keeps running after you quit the wall.

  • It listens on 127.0.0.1 only. Port 4747 is the default.
  • Its log is ~/.garage/daemon.log. Your state is in ~/.garage/state.json.
  • Press q in the wall to quit. The daemon and every session keep running. This works because tmux owns your Claude Code sessions.
  • To restart only the daemon, run claude-garage restart, or press r d in the wall. Your sessions are not touched.
  • If port 4747 is taken, set GARAGE_PORT to another number. See Configuration.

A normal start prints nothing before the wall opens. To see what the launcher does, set GARAGE_VERBOSE:

Terminal window
GARAGE_VERBOSE=1 claude-garage

The launcher then prints lines such as “no daemon on port 4747, starting one”. It also tells you when it replaces an old daemon. Errors and questions always print, with or without this variable.

Run claude-garage again. It finds the old daemon, stops only that process and starts the new one. No session is closed. The changelog lists what changed in each version.

Your shell cannot find the binary. The shell installer puts it in ~/.local/bin. Check that folder is on your PATH:

Terminal window
echo "$PATH" | tr ':' '\n' | grep -x "$HOME/.local/bin"

If that prints nothing, add export PATH="$HOME/.local/bin:$PATH" to your shell profile and open a new terminal. With npx, no PATH change is needed. Run npx claude-garage instead.

claude-garage needs tmux on macOS and Linux and stops when it is missing. On macOS with Homebrew, it asks tmux not found. Install it now with Homebrew? [y/N]. Answer y to run brew install tmux. Elsewhere it prints the commands: apt install tmux, dnf install tmux or pacman -S tmux. Then run claude-garage again.

The launcher could not run claude --version, so Claude Code is not installed or is not on the PATH of this terminal. The message points to the Claude Code install instructions. Install it, open a new terminal, check claude --version, and run claude-garage again.

claude-garage needs tmux 3.2 or newer and refuses to start on an older one. It prints tmux 3.1c is too old — claude-garage needs tmux 3.2 or newer, followed by the upgrade command: brew upgrade tmux on macOS, or your package manager on Linux. Check your version with tmux -V.

Another program already uses the daemon port. The full message ends with set GARAGE_PORT to use another port. Pick a free port:

Terminal window
GARAGE_PORT=4800 claude-garage

See Configuration for making it permanent. If an old claude-garage daemon holds the port, claude-garage restart replaces it without touching sessions.

The wall waited for the daemon and gave up. The full message names the log file. Read the end of ~/.garage/daemon.log. A taken port is the most common cause, covered above.

Is it safe to pipe the installer into a shell?

Section titled “Is it safe to pipe the installer into a shell?”

Piping a download into sh or iex runs the script before you have read it. The commands above fetch the installer from this project’s GitHub Releases over HTTPS only (--proto '=https' --tlsv1.2), but you are still trusting that download. To read it first:

Terminal window
curl --proto '=https' --tlsv1.2 -LsSf -o claude-garage-installer.sh \
https://github.com/adar2378/claude-garage/releases/latest/download/claude-garage-installer.sh
less claude-garage-installer.sh
sh claude-garage-installer.sh

On Windows, download claude-garage-installer.ps1 from the releases page, read it, then run it. If you prefer not to run an installer at all, use npx claude-garage. Report a security problem through the GitHub security advisories.

These steps are for macOS and Linux. The Windows preview has no tested uninstall steps yet.

  1. Quit the wall with q. Sessions and the daemon keep running.

  2. Optional: end the sessions. They are tmux sessions named garage/<project>/<label>, so they would keep running otherwise. Kill them one at a time, or all at once:

    Terminal window
    tmux list-sessions -F '#{session_name}' | grep '^garage/' | while read -r s; do tmux kill-session -t "=$s"; done
  3. Stop the daemon. The launcher itself suggests this command when it cannot stop an old daemon:

    Terminal window
    lsof -ti tcp:4747 | xargs kill
  4. Remove the binary. If you used the shell installer:

    Terminal window
    rm ~/.local/bin/claude-garage

    If you only used npx, nothing was installed on your PATH, so there is nothing to remove.

  5. Remove garage’s files. This deletes your saved session records, so closed chats can no longer be restored:

    Terminal window
    rm -rf ~/.garage

    If you set GARAGE_DIR, remove that folder instead.

  6. If you pressed I in the wall, claude-garage added hooks and a statusline to ~/.claude/settings.json. Before each write it saved a copy named settings.json.garage-backup-<timestamp> in the same folder. Restore that copy, or remove the entries that point at files in ~/.garage by hand. If you set GARAGE_CLAUDE_HOME, look there.

Your sessions’ Claude conversations stay in Claude Code’s own history. Removing claude-garage does not delete them.

Start with Your first wall. Then see how to run many sessions, keep sessions alive, or the key reference. If you are weighing options, read claude-garage vs tmux on its own.

If garage works for you, star it on GitHub. It is free and built by one person, and stars are how other Claude Code users find it.