Add-ons
Make Gerdr yours: quota and spend in the sidebar, hold-to-talk voice dictation and hands-free reading, approving agents' commands right from Slack… one click in the store installs them, no restart. Not there? Ask an agent to write one; it works on save.
In Gerdr's settings they're under Add-ons.
Install Gerdr (https://github.com/gerdr-dev/gerdr) on this computer for me: follow the install instructions in its README, download the right package for my system, install it and open it. If Claude Code or Codex isn't installed or logged in, install it too and tell me how to do the login step.
Settings → Add-ons → Store, then click Install. The default store is gerdr-dev/gerdr-addon, and any GitHub repository can be added as a store.
Just say "install the usage meter". The agent runs gerdr addon install usage-meter; changing settings, turning add-ons on and off, and updating work the same way.
Describe what you want; the agent writes it into ~/.gerdr/addons/ and it works on save. See below.
What's in the store
Click a screenshot to enlarge it.
Keep an eye on usage
Quota, spend and cache, without looking anywhere elseClaude Code / Codex quota always at the bottom of the sidebar: how much of the 5-hour and weekly limits you've used; click for every limit and when it resets.
Shows in the sidebar how many tasks your agents finished today and what they cost, with a 7-day bar chart and custom price tables for Gerdr Agent tokens.
Warns before the prompt cache expires: yellow "expires in N min" next to the latest turn, turning red once expired. Configurable TTL for subscription (60m) or API (5m).
Smoother to use
Less typing, fewer window switchesHold 🎤 (or right Option / right Alt on desktop) to dictate live into the composer with context-aware fix-up (Doubao, SiliconFlow / OpenAI-compatible). Tap to hear replies or hold for hands-free queued auto-read (Doubao, Xiaomi MiMo, Azure, SiliconFlow).
A ⚡ in the input box's bottom bar fills in things you say all the time, like "continue" or "commit first"; right-click to quote the selected text into the input box.
prefix+a / prefix+i duplicates the current tab after / before it: same folder, same agent, a new session.
A system notification when a session you can't see finishes or is waiting for your approval.
An example add-on: decide for yourself how sessions get titled. This one re-summarizes every 5 messages and puts the agent in front of the title.
A different look
Swaps the accent color (your message bubbles, buttons, links, focus rings) for one you pick; dark theme adjusts automatically.
7 pixel Clawd sprites: use one as the working indicator (walking with props while running, waving while waiting on you) or as agent avatars and rail icons.
Connect to the outside
Get notified and reply even when you're away from your computerWhen an agent waits for an approval or an answer and you're away from your computer, it DMs you on Slack, Feishu… reply with a number and it carries on.
DMs to your Slack bot and @-mentions become Gerdr events with automatic attachment download, and replies go out as the bot. A clean front door for assigning work.
Slack DMs (and optional @-mentions) sent to you personally become events, and replies go out as you; no Slack app needed, reuses your desktop sign-in.
Watches the MRs you're waiting on: comments, pipelines, conflicts, mergeable status. Agents wait with gerdr wait and pick up automatically when something changes.
Mac
A button on the rail that keeps your Mac awake even with the lid closed so agents keep running; customizable icon (supports animated sprites), lets go on low battery and survives restarts.
Write your own
The easiest way is to let an agent write it. Tell any agent in Gerdr what you want, for example:
It knows how add-ons are written (Gerdr ships a developer guide and full type definitions), puts the result in ~/.gerdr/addons/, and the UI changes right away: no node to install, no build, no restart. Not happy? Keep talking.
What add-ons can do
- Draw UI: in the sidebar, tile titles, the input box's bottom bar, context menus, and the time line under each turn.
- Rename things: tab names, tile titles, workspace names, session titles.
- Commands and shortcuts: add them to the command palette and bind a key.
- Listen for events and act: do something when a turn finishes, an agent waits for your answer, a session starts or focus changes, like showing a notification.
- Settings: declare them and a form appears in Settings → Add-ons.
- Theme colors: override Gerdr's colors; turning the add-on off restores them.
- Background processes: Gerdr starts them and restarts them if they crash, e.g. a constant connection to Slack or a Bluetooth band.
Prefer to do it yourself? An add-on is just a folder:
~/.gerdr/addons/hello/ addon.json name, version, description, icon, screenshots index.ts the code README.md shown when "Details" is expanded in the store
export default defineAddon({
setup(g) {
g.paneTitle((pane, { label }) => "AI · " + label)
g.command({
id: "hello", title: "Say hello", key: "prefix+y",
run: () => g.notify("hello"),
})
},
})Publishing: put the folder in a GitHub repository and that repository is a store; others enter owner/repo on the store page to install it. PRs straight to gerdr-addon are welcome too.
The full API and examples: the add-on developer guide (also on any computer with Gerdr: ~/.gerdr/addons/GUIDE.md).