# Add-ons · Gerdr

> Gerdr add-ons: usage meter, today's spend, voice dictation & auto read, quick phrases, theme colors, Slack / GitLab, lid-awake… one click to install from the store. Want something else? Have an agent write it for you; it works on save.

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.

Copy this text

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](https://github.com/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](#write).

## 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](https://fsu.creght.com/site/2117042939526909952/1794577444562__usage_meter_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577443980__usage_meter_icon.svg)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.

`gerdr addon install usage-meter` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/usage-meter)

![Today](https://fsu.creght.com/site/2117042939526909952/1794577442763__today_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577442195__today_icon.svg)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.

`gerdr addon install today` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/today)

![Cache clock](https://fsu.creght.com/site/2117042939526909952/1794577432441__cache_clock_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577431737__cache_clock_icon.svg)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).

`gerdr addon install cache-clock` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/cache-clock)

02

### Smoother to use

Less typing, fewer window switches

![](https://fsu.creght.com/site/2117042939526909952/1795317880716__voice_icon.svg)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).

`gerdr addon install voice` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/voice)

![Quick phrases](https://fsu.creght.com/site/2117042939526909952/1794577438022__quick_phrases_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577437357__quick_phrases_icon.svg)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.

`gerdr addon install quick-phrases` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/quick-phrases)

![Duplicate tab](https://fsu.creght.com/site/2117042939526909952/1794577434244__duplicate_tab_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577433600__duplicate_tab_icon.svg)Duplicate tab

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

`gerdr addon install duplicate-tab` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/duplicate-tab)

![](https://fsu.creght.com/site/2117042939526909952/1794577436789__notify_when_done_icon.svg)Notify when done

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

`gerdr addon install notify-when-done` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/notify-when-done)

![](https://fsu.creght.com/site/2117042939526909952/1794577439207__session_title_icon.svg)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.

`gerdr addon install session-title` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/session-title)

03

### A different look

![Theme color](https://fsu.creght.com/site/2117042939526909952/1794577441436__theme_color_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577440858__theme_color_icon.svg)Theme color

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

`gerdr addon install theme-color` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/theme-color)

![Pixel Clawd](https://fsu.creght.com/site/2117042939526909952/1795317881413__clawd_loader_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577433001__clawd_loader_icon.svg)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.

`gerdr addon install clawd-loader` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/clawd-loader)

04

### Connect to the outside

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

![](https://fsu.creght.com/site/2117042939526909952/1794577438599__remote_answer_icon.svg)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.

`gerdr addon install remote-answer` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/remote-answer)

![](https://fsu.creght.com/site/2117042939526909952/1794577439876__slack_me_icon.svg)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.

`gerdr addon install slack` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/slack)

![](https://fsu.creght.com/site/2117042939526909952/1794577439876__slack_me_icon.svg)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.

`gerdr addon install slack-me` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/slack-me)

![](https://fsu.creght.com/site/2117042939526909952/1794577434922__gitlab_icon.svg)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.

`gerdr addon install gitlab` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/gitlab)

05

### Mac

![Lid awake](https://fsu.creght.com/site/2117042939526909952/1794577436061__lid_awake_screenshot.png?w=3072&fmt=webp)

![](https://fsu.creght.com/site/2117042939526909952/1794577435494__lid_awake_icon.svg)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.

`gerdr addon install lid-awake` [Source](https://github.com/gerdr-dev/gerdr-addon/tree/main/lid-awake)

## 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](https://github.com/gerdr-dev/gerdr-addon) are welcome too.

The full API and examples: the [add-on developer guide](https://github.com/gerdr-dev/gerdr/blob/main/internal/addons/builtin/GUIDE.md) (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](/docs.md#panels).

> Full page index: [/llms.txt](/llms.txt)
