Configuration
garage works without any setup. This page lists the settings you can change.
The garage folder
Section titled “The garage folder”garage keeps its files in ~/.garage. Set GARAGE_DIR to use another folder. Files in it:
config.toml: your settings (you create it)state.json: sessions and projectswall.json: wall layout, views and the pet choicedaemon.log: the daemon’s logdrafts/: kept draftsworktrees/: worktree sessions
config.toml
Section titled “config.toml”Create ~/.garage/config.toml. It has two options. Both are true or false.
animations = truedrafts = true| Option | Default | Effect |
|---|---|---|
animations |
true |
Fade-ins, the attention pulse and the closing dissolve. Set false for a still wall. |
drafts |
true |
Keeps unsent prompts so you can restore them with u. Set false to keep nothing. |
The file is read when the wall starts. Restart the wall after a change.
Environment variables
Section titled “Environment variables”Set a variable in front of the command, or export it in your shell profile.
GARAGE_PORT=4800 claude-garage| Variable | Default | Effect |
|---|---|---|
GARAGE_PORT |
4747 |
The daemon port. It always binds 127.0.0.1. |
GARAGE_DIR |
~/.garage |
The folder for garage’s files. |
GARAGE_VERBOSE |
off | 1, true or yes makes the launcher print what it does while it starts. |
GARAGE_NO_MOTION |
off | Turns animations off. NO_MOTION and REDUCE_MOTION work the same way. Empty, 0, false, no and off count as not set. |
GARAGE_DRAFTS |
on | 0, false, no or off turns draft recovery off. |
GARAGE_TMUX_CONTROL |
on | 0, false, no or off turns off tmux control mode. See below. |
GARAGE_TMUX_SOCKET |
unset | Use a separate tmux server with this name. It also skips your tmux.conf. For testing and isolation. |
GARAGE_BACKEND |
tmux on macOS and Linux, host on Windows |
tmux or host. The host backend runs each session in its own small process, with no tmux. |
GARAGE_CLAUDE_CMD |
claude |
The program that sessions run. |
GARAGE_CLAUDE_HOME |
~/.claude |
Where I writes the hooks and statusline. |
Turn animations off
Section titled “Turn animations off”Use any one of these:
GARAGE_NO_MOTION=1 claude-garageanimations = falseTurn drafts off
Section titled “Turn drafts off”GARAGE_DRAFTS=0 claude-garagedrafts = falseWhen drafts are off, garage also removes the drafts it kept before. See Nothing gets lost.
The tmux control off switch
Section titled “The tmux control off switch”By default the daemon opens a tmux control-mode client. It learns about session changes at once. It uses a hidden tmux session named garage-control. That session shows up in tmux ls. A bare tmux attach right after the daemon starts can land in it. Some tmux session savers can save it.
If this is a problem, turn control mode off:
GARAGE_TMUX_CONTROL=0 claude-garageThe daemon then checks sessions on a plain 2-second timer. Nothing else changes. The variable is read by the daemon, so restart the daemon after you set it: claude-garage restart. It must be set in the environment that starts the daemon.
Plugin keys
Section titled “Plugin keys”Plugin settings are not in config.toml. Turn plugins on and off, and change their keys, with claude-garage plugin enable, disable and bind. See Plugins.
Back to Install, or open the Plugins docs section to write your own plugin.