Use and install plugins
A plugin adds a key, a button, a status widget, a panel or a command to garage. Ten plugins are built into the binary. You can add more from GitHub or write your own.
The ten built-in plugins
Section titled “The ten built-in plugins”Six are on after your first run. Four are off.
| Plugin | Default | What it does | Key |
|---|---|---|---|
usage-bar |
on | Shows your 5-hour and weekly Claude usage in the strip. It keeps the last figures across restarts. | none |
closed-chats |
on | Keeps closed chats in the rail as grey rows. A panel lists the recent ones. | H |
quick-send |
on | Sends one line of text to a session, or to every session of the project. | s, S |
tile-buttons |
on | Adds x (close) and del (delete) buttons to every tile title bar. |
click |
pit-pet |
on | A pet lives in the strip and reacts to your sessions. The pet is off until you press P. |
P |
alerts |
on | Plays a chime, and shows a desktop banner when no garage window is in view, when a session needs you or finishes a long turn. Options: claude-garage alerts. |
none |
turn-markers |
off | Draws a marker in the tile gutter where each Claude turn ended. | none |
jump-palette |
off | Opens a fuzzy search over sessions and projects. Choose one to focus it. | / |
prune-empty-projects |
off | Removes a project from the rail when you close its last chat. | none |
cli-extras |
off | Adds claude-garage <folder>, claude-garage open, install and prune to the command line. |
none |
More detail:
- alerts: see Know when Claude Code needs you for the options. Press
pand switch it off to silence it for good. - usage-bar takes its figures from the Claude Code statusline. Press
Ionce to install it. - closed-chats:
Hopens “Recent chats”. - quick-send needs
Entertwice in its popup, so nothing is sent by accident.Sskips sessions that wait for input.son a waiting session asks for an extrayfirst, because your line would answer its prompt. - tile-buttons: the first click arms the button. The second click runs it.
xcloses the session, and it stays in the rail as a grey row.delkills the session and keeps no history. There is no way back. - pit-pet:
Pcycles off, Arthur the cat, Papito the duck, Segan the pup, and off again. - cli-extras: after you enable it,
claude-garage ~/dev/appadds the folder as a project, starts a session if it has none, and opens the wall.claude-garage prunelists projects with no session and asks before it removes them. It accepts--yesand--dry-run.
Press ? in the wall. Keys from plugins are listed in a “Plugins” section.
Turn a plugin on or off
Section titled “Turn a plugin on or off”-
List what you have:
Terminal window claude-garage plugin list -
Enable or disable one:
Terminal window claude-garage plugin enable jump-paletteclaude-garage plugin disable usage-bar -
Change a key if you like:
Terminal window claude-garage plugin bind quick-send:send tclaude-garage plugin bind quick-send:send --clear
If you disable a plugin, it stays disabled. A built-in plugin cannot be removed, only disabled. Later releases add new plugins in the off state.
Install a plugin from GitHub
Section titled “Install a plugin from GitHub”Plugins are programs. They run as you. They are not sandboxed. Read the preview before you say yes.
-
Install by
owner/repo. Add/subdirif the plugin is in a folder of the repository:Terminal window claude-garage plugin install owner/repo -
Read the preview. Nothing from the plugin has run yet. It shows:
- the name, version, source and license
- the permissions, with dangerous ones marked
DANGEROUS - every command the plugin will run, as an exact argument list
-
Answer the question. For a plain plugin it reads
Install <id>? [y/N]. Onlyyoryescontinues. For a plugin with a dangerous permission it readsInstall <id> including DANGEROUS permissions (...)?. -
Pin a version when you can:
Terminal window claude-garage plugin install owner/repo --ref v1.2.0
Two permissions are dangerous. sessions.input can type into your sessions. core.actions can close or delete sessions.
For scripts, --yes skips the question but not the preview. A dangerous plugin also needs --allow-dangerous.
Updates ask again only if commands, permissions or download addresses changed:
claude-garage plugin update --allThe confirm rule
Section titled “The confirm rule”A plugin can ask to close or delete a session. It can never confirm. The wall arms the action, and you must press a key or click a second time. A plugin cannot send “confirmed”.
Stop or remove a plugin
Section titled “Stop or remove a plugin”claude-garage plugin disable <id> # stops it at onceclaude-garage plugin remove <id> --purge # deletes it and its dataclaude-garage plugin logs <id> -f # follow its logFind plugins
Section titled “Find plugins”claude-garage plugin searchclaude-garage plugin search quick notes --sort updatedSearch lists public GitHub repositories with the topic claude-garage-plugin. The results are not reviewed. A result is not a recommendation. Use --sort stars (default) or --sort updated, and --limit to change the count.
Write your own
Section titled “Write your own”-
Create a working plugin. Choose
rust(default),tsorshell:Terminal window claude-garage plugin new my-plugin --lang shellcd my-plugin -
Start dev mode. It links the folder, rebuilds when files change, reloads the plugin and shows its log:
Terminal window claude-garage plugin dev -
Edit
garage-plugin.tomland your code. Save. The plugin reloads. -
To share it, push it to a public GitHub repository and add the topic
claude-garage-plugin. Others install it withclaude-garage plugin install you/my-plugin.
The manifest, events, widgets, panes and the HTTP API are in the Plugins docs section: Plugin documentation.