Omarchy plugin

Ambient Agent — your desktop feels what your agents are doing.

No pop-ups stealing focus. The screen edge breathes while an agent works, warms to amber the moment one needs your call, and gives a quiet green pulse when it's done. Peripheral awareness, not interruption.

$omarchy plugin add https://github.com/fjalvarezdd/omarchy-ambient-agent --enable
★ GitHub ↗
12345 ◷ 00:47 ♪ Radiohead — 15 Step AGENTS ↓2K ↑1KCPU 6%BAT 99%
idlenothing running
? Agent needs you
“Apply 3 edits to bindings.lua?” — waiting 40s

The states

Working

A lit segment snakes around the edge in your selected theme accent — like a loading wheel, but the whole screen. Calm, alive.

snake · theme accent

Needs you

Warms to amber and quickens. The one state that earns your attention: an agent is blocked on a decision.

pulse · 1.5s · toast

Done

When it finishes, the edge settles to a steady, solid blue all the way around — unmistakable, no flashing.

solid · blue

Error

Red, sharper cadence. Something failed and wants eyes. Distinct enough from “needs you” to read across the room.

pulse · 1.1s

Why it's different

The blind spot in multi-agent work

Omarchy already shows agent usage and limits (omarchy.agents). What it can't tell you is the thing that actually costs you time when you run several agents at once: which one is silently waiting for you.

Ambient Agent answers that through the room, not through a notification tray. The bar orbs scale to N agents; the edge shows the most urgent state:

needs you › error › working › done › idle

How it works

One file. One overlay.

  • 1Your agent (or any command) writes one word — working, needs, done — to a tiny state file.
  • 2A Quickshell layer-shell overlay watches that file and paints the edge glow. Transparent, click-through, zero input capture.
  • 3No daemon, no dependencies beyond the Omarchy shell. Drive it from a hook or wrap a command.
agent-ambient working
npm run build
agent-ambient done

Make it yours

Configurable, hot-reloaded

Edit ~/.config/omarchy/ambient-agent.json — colors to match your theme, calmer glow, slower breathing, or off entirely. No restart.

{
  "colors": { "working": "#7dcfff", "needs": "#e0af68", "done": "#9ece6a", "error": "#f7768e" },
  "glowWidth": 26, "glowOpacity": 0.40, "borderWidth": 3,
  "periods": { "working": 3800, "needs": 1500 },
  "enabled": true
}

Feel your agents.

One command on any Omarchy machine. MIT, no dependencies.

Get it on GitHub ↗

Ambient Agent · built for Omarchy · by @fjalvarezdd