What Is This?
EliaTopBar sits in your macOS menu bar and gives you real-time command over the
Elia agent ecosystem — without opening a browser
or terminal. It connects over WebSocket to the Elia FastAPI server (localhost:5656)
and turns every subworker into a live, actionable dashboard row.
- 🟢 Live agent states pushed over WebSocket — running, idle, disabled, error, done
- 📍 Per-agent menu bar icons — each running subworker gets its own top-bar dot with a
monogram, colored by state (green = healthy, red = error)
- 💬 Drop livestreams — when an agent starts, its photo drops from the menu bar
with a live chat bubble streaming the run output (terminal/tool/skill/todo banners) —
visible even over fullscreen video, draggable anywhere, auto-retracts, click to dismiss
- 🧬 Subagent matrix — background agents, team members and delegated tasks surface as
live Grok pills in a side strip (left/right) with per-team grouping, kind badges and
click-to-expand full livestream bubbles
- ✅ Todo tracking — fused todo card + hover side panel with live progress, one line per task
- 🖱️ Click-to-view LogViewer — click an agent photo to open the full session browser
(sessions, messages, reasoning, tool calls, live stream), always clamped inside the screen
- 🎭 Profiles — Developer (full livestream), Calm (essentials), Minimal (dots + LogViewer)
one-tap setups for dev and non-dev use
- ⚡ Manual Run Subworker — trigger any subworker on demand from a dropdown
- 🦀 Two servers, clearly labelled — the subworker API (
subworker-opencode-rust, port 5656)
and the OpenCode agent engine (opencode-rust, port 3000) both have Start/Stop controls in
the same submenu, so every button says what it actually starts: Start Colima,
Start Rust Server, Stop Rust Server. Starting the Rust server shows an elapsed
timer instead of freezing the menu.
- 🔁 Enable / Disable, next run, schedule — per-agent submenu with everything you need
- ⚙️ Topbar Settings — profiles, Drop panels, menu bar layout with live preview,
run animation, viewer choice — zero permissions required
- ❤️ Server health — connection state, PID, restart count, reconnect button, one-click RAM cleanup
- ⏱️ Loading + error states everywhere — every server-loaded menu shows a spinner
while fetching, then data — or the full error message if it fails
It also retains full Colima container management: start / stop / restart instances,
open a shell, inspect resources, delete, auto-refresh and launch-at-login.
✨ Features
🤖 Subworker Dashboard (EliaAgent)
| Feature | Description |
|---|
| WebSocket live updates | Real-time status pushed from the Elia FastAPI server (ws://localhost:5656/ws) |
| Active Agents list | Every subworker with live state: ⚡ Running, ⏸️ Idle, ⛔ Disabled, 💥 Error, ✅ Done |
| Per-agent top bar icons | Running agents each get a colored status dot with their monogram in the menu bar |
| Run popup animation | Agent photo drops from the icon + live output bubble when a run starts — visible over fullscreen video, draggable (stays where dropped), auto-retracts (configurable), click to dismiss |
| Drop livestream | Full renderer mirroring LogViewer: terminal / skill / todo / edit / write banners, coalesced reasoning, traffic ↓/↑, tool+message counters, session switcher |
| Subagent matrix | call_omo (bg) / team / task pills with static-square Grok animation while working, ✅ when done (result-collected detection), per-team columns, expandable bubbles |
| Todo strip | Fused todo card in-bubble + hover side panel with done/total, one row per task, colored status dots |
| LogViewer | Full session browser per agent: sessions list, messages, reasoning, tool-call banners, live stream — always clamped inside the screen |
| Profiles | Developer / Calm / Minimal one-tap setups — full livestream for builders, essentials for followers, dots-only for non-devs |
| Drop panels settings | Show/hide stats header, todo strip, subagent strip; subagents left/right; team tasks above/side — all live, no restart |
| Topbar Settings panel | Version badge, logo, GitHub link, agent photos side (left/right of banner), live padding slider, run animation duration + test trigger — no permissions needed |
| Manual Run Subworker | Trigger any subworker from a dropdown — no terminal needed |
| Per-agent submenu | Status, next run, schedule, last run, view logs, trigger now, enable / disable |
🐳 Colima Instance Management
| Feature | Description |
|---|
| Instance list | All Colima instances in the menu, ● running / ○ stopped |
| Instance submenu | Status, arch, CPUs, memory, disk |
| Start / Stop / Restart | Control each instance individually |
| Open Shell | Launch Terminal and SSH into the running instance |
| Delete… | Remove an instance (with confirmation) |
| Auto-refresh | Configurable polling interval (5 / 10 / 30 / 60 seconds) |
| Launch at Login | Start automatically when you log in |
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
