Busabase for Omarchy

Your agents' work, kept

The Busabase mark in your Omarchy bar counts what you and your agents kept today, and flashes +1 as each one lands.

Run in a terminal on Omarchy

omarchy plugin add https://github.com/busabase/omarchy-busabase.git --enable

Read the install guideSource on GitHub
Busabase
Omarchy Plugin
Omarchy desktop: Codex saves a record to Busabase while the Busabase panel in the bar lists what agents kept today

Install in one command

Run the command, sign in once, and switch on the skill.

Install

Run the install command in a terminal. The Busabase mark appears on the right of your bar.

Sign in

Click the mark, then Sign in to Busabase. busabase-cli login opens in Omarchy's floating terminal.

Teach your agents

Switch on Teach my agents Busabase to link the Busabase skill into Claude Code, Codex, Pi and ~/.agents/skills.

Ask an agent to keep something

When it lands, the bar flashes +1 and the panel lists it.

See it on Omarchy

Screenshots from a real Omarchy desktop.

The Busabase mark in the bar going from 1 to +1 to 2
An agent saves a record: the count flashes +1, then settles on the new total.
The Busabase panel listing today's kept changes and one change waiting for review
The panel lists what was kept today in plain words, and flags a change waiting for review.
Omarchy's floating terminal running busabase-cli login
Sign-in runs busabase-cli login in Omarchy's floating terminal.
The panel before sign-in, with Sign in to Busabase and Teach my agents Busabase
Not connected yet: one click to sign in, one switch to teach your agents.
The Teach my agents Busabase switch, on for Claude Code, Codex and Pi
The skill switch, on for Claude Code, Codex and Pi.

What the bar shows

Work your agents do on their own should be visible, not interrupting. No toast, no sound.

In the bar and its panel

Today's count, with a +1 as each change lands.

What was kept, in plain words: “Codex added 1 record to Bugs · 5m ago”.

Each row opens in Busabase, with the full history and one-click revert.

An accent dot, only when one of your changes waits for review.

One switch links the Busabase skill into Claude Code, Codex, Pi and ~/.agents/skills.

Every change you see can be opened, and undone

Busabase keeps each change as a Change Request with a message, a diff, and history. The panel takes you straight to it.

An agent saves

Claude Code or Codex writes to Busabase. The panel names it after the agent client or the API key it used.

The bar counts it

The count flashes +1, and the panel adds a line in plain words.

You open it

Busabase shows the full history. If the change is wrong, revert it in one click.

Cloud, self-hosted, or local

Sign-in runs busabase-cli login, so the widget uses whichever Busabase the CLI connects to.

Busabase Cloud

Choose Busabase Cloud in the sign-in terminal, then approve the short code in your browser.

Local open-source server

Run busabase server on your own machine, no account needed. Use Busabase on this computer appears in the panel when a server answers on localhost:15419.

Self-hosted Busabase

Choose a self-hosted server in busabase-cli login and enter your team's Busabase URL.

Plugin questions

Will it interrupt me?

No. There is no toast and no sound. The count flashes +1 and settles; a dot appears only when one of your changes waits for review.

I already use busabase-cli. Do I sign in again?

No. The widget reads the same ~/.busabase/.env that busabase-cli login writes.

What does it send over the network?

Only GET requests to your Busabase server, every 60 seconds by default. The API key never appears on a command line.

How do I remove it?

Switch Teach my agents Busabase off, then run omarchy plugin remove busabase. Your Busabase data and ~/.busabase/.env are untouched.

Put your agents' work in the Omarchy bar

Copy the install command, run it on Omarchy, and sign in once.

Run in a terminal on Omarchy

omarchy plugin add https://github.com/busabase/omarchy-busabase.git --enable