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.
How do I install claude-garage?
Section titled “How do I install claude-garage?”-
Pick one install method. Each one downloads a prebuilt binary. Nothing is compiled.
Run it with npx:
Terminal window npx claude-garageOr 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 | shIt 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" -
Make sure tmux is installed. On macOS, claude-garage offers to run
brew install tmuxfor you. It asks first. On Linux, install it yourself:Terminal window sudo apt install tmuxUse
dnf install tmuxorpacman -S tmuxon other distributions. -
Start the wall:
Terminal window claude-garageThe shell installer puts the binary in
~/.local/bin. Add that folder to yourPATHif the command is not found.
What should I see after install?
Section titled “What should I see after install?”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.
What does the daemon do?
Section titled “What does the daemon do?”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.1only. Port4747is the default. - Its log is
~/.garage/daemon.log. Your state is in~/.garage/state.json. - Press
qin 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 pressr din the wall. Your sessions are not touched. - If port 4747 is taken, set
GARAGE_PORTto another number. See Configuration.
How do I see what the launcher does?
Section titled “How do I see what the launcher does?”A normal start prints nothing before the wall opens. To see what the launcher does, set GARAGE_VERBOSE:
GARAGE_VERBOSE=1 claude-garageThe 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.
How do I upgrade from 0.6.x?
Section titled “How do I upgrade from 0.6.x?”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.
Troubleshooting
Section titled “Troubleshooting”command not found: claude-garage
Section titled “command not found: claude-garage”Your shell cannot find the binary. The shell installer puts it in ~/.local/bin. Check that folder is on your PATH:
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.
tmux not found
Section titled “tmux not found”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.
claude not found
Section titled “claude not found”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.
My tmux is older than 3.2
Section titled “My tmux is older than 3.2”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.
cannot bind 127.0.0.1:4747; is it taken?
Section titled “cannot bind 127.0.0.1:4747; is it taken?”Another program already uses the daemon port. The full message ends with set GARAGE_PORT to use another port. Pick a free port:
GARAGE_PORT=4800 claude-garageSee Configuration for making it permanent. If an old claude-garage daemon holds the port, claude-garage restart replaces it without touching sessions.
claude-garage daemon did not come up
Section titled “claude-garage daemon did not come up”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:
curl --proto '=https' --tlsv1.2 -LsSf -o claude-garage-installer.sh \ https://github.com/adar2378/claude-garage/releases/latest/download/claude-garage-installer.shless claude-garage-installer.shsh claude-garage-installer.shOn 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.
How do I uninstall claude-garage?
Section titled “How do I uninstall claude-garage?”These steps are for macOS and Linux. The Windows preview has no tested uninstall steps yet.
-
Quit the wall with
q. Sessions and the daemon keep running. -
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 -
Stop the daemon. The launcher itself suggests this command when it cannot stop an old daemon:
Terminal window lsof -ti tcp:4747 | xargs kill -
Remove the binary. If you used the shell installer:
Terminal window rm ~/.local/bin/claude-garageIf you only used
npx, nothing was installed on yourPATH, so there is nothing to remove. -
Remove garage’s files. This deletes your saved session records, so closed chats can no longer be restored:
Terminal window rm -rf ~/.garageIf you set
GARAGE_DIR, remove that folder instead. -
If you pressed
Iin the wall, claude-garage added hooks and a statusline to~/.claude/settings.json. Before each write it saved a copy namedsettings.json.garage-backup-<timestamp>in the same folder. Restore that copy, or remove the entries that point at files in~/.garageby hand. If you setGARAGE_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.