ADD-ONS / EXTENSIONS

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.

You don't really need these docs

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.

Then just ask it:Switch to the dark themeInstall the quota meter add-onMake a weekly-report panel for this project
Install from the store

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.

Have an agent install it

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.

Have an agent write one

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.

01

Keep an eye on usage

Quota, spend and cache, without looking anywhere else
Usage meter

Claude 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.

Source
Today

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.

Source
Cache clock

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).

Source
02

Smoother to use

Less typing, fewer window switches
Voice

Hold 🎤 (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).

Source
Quick phrases

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.

Source
Duplicate tab

prefix+a / prefix+i duplicates the current tab after / before it: same folder, same agent, a new session.

Source
Notify when done

A system notification when a session you can't see finishes or is waiting for your approval.

Source
Session titles: redo every 5 messages

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.

Source
03

A different look

Theme color

Swaps the accent color (your message bubbles, buttons, links, focus rings) for one you pick; dark theme adjusts automatically.

Source
Pixel Clawd

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.

Source
04

Connect to the outside

Get notified and reply even when you're away from your computer
Approve from chat

When 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.

Source
Slack

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.

Source
Slack DMs (my account)

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.

Source
GitLab MR

Watches the MRs you're waiting on: comments, pipelines, conflicts, mergeable status. Agents wait with gerdr wait and pick up automatically when something changes.

Source
05

Mac

Lid awake

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.

Source

Write your own

The easiest way is to let an agent write it. Tell any agent in Gerdr what you want, for example:

Write an add-on: put how much this session spent today in front of the tab name, and make it red over $5.

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).

Add-ons vs. panels: add-ons change Gerdr itself (in every project); a panel is a small app inside one project, with its own page and assistant. For panels, see Docs · Custom panels.

Render diagnostics