01 / The cockpit

Supervise every coding agent from a single cockpit.

Oragent shows which agent is working, which is waiting, and lets you pre-approve the permissions you'd say yes to anyway.

pipx install oragent

Python ≥ 3.11 · tmux · macOS / Linux today, Windows next.

Oragent  · Agent Dashboard ·  Auto-Focus
Sessions
  • ~ Home
  • * cc-refactor-auth working
  • o codex-test-suite idle
  • o cc-db-migration idle
  • * codex-typecheck working
  • a codex-build-rc auto
  • o cc-docs-rewrite idle
  • $ shell-tail-logs shell
  • x cc-old-branch stopped
cc-refactor-auth · claude · ~/app
● Refactoring the auth module.
 
● Read(src/auth/session.ts)
⎿ Read 142 lines
 
● Update(src/auth/session.ts)
⎿ Updated · +12 −3
 
● Bash(npm run typecheck)
⎿ tsc --noEmit · 0 errors
 
● Watching for changes…
! User requested approval
Bash DROP COLUMN legacy_token in ~/app
[a] Allow [d] Deny
> esc to interrupt
n New i Interactive a Allow d Deny r Rename ^S Stop/Start p Pilot ^X Del b Report f Fit
auto-focused

02 / Wrong shelf, right shelf

Nowadays, concurrency is all you need. Oragent lets you talk to all your agents.

Not a multi-agent framework.

Not an orchestrator.

Not another terminal multiplexer.

An Agent Supervisor.

State-aware. Opinionless. Human-driven. One operator, many agents, one cockpit.

What you actually do

  • Answer the ones that are waiting.
  • Put the routine ones on auto.
  • The rest just keeps running.

Everything else is the fleet's job — not yours.

03 / How it actually works

Three things Oragent does for you.

Reads each agent's state.

Pane-level pattern matching classifies every session into one of seven states. Refreshed in real time; typical capture cost is ~6ms.

live sessions · 7 of 32 * frontend-refactor working ! test-fix waiting o data-migration idle a oragent-upgrade auto $ top shell x keys-test stopped ? reconnecting unknown

Pre-approves the permissions you'd say yes to anyway.

Per-session Auto Pilot. When Oragent recognizes a permission prompt whose routine answer it knows, it answers automatically. Real judgment calls still come through. Toggle on with p; the row turns a auto electric blue.

oragent-upgrade · Auto Pilot ON bump dependencies auto regenerate types auto format sources auto patch changelog auto run test suite auto > Run `rm -rf node_modules` ! waiting auto-approved · 248 commands · 1 escalated

Routes waiting to the front of your attention.

When any session blocks on a permission, Oragent moves focus to it via a FIFO queue. Multiple waitings? First one in, first one you reply to.

attention queue · FIFO * oragent-deploy working ! oragent-page focused ! atoms-bugs ! deepflow-auto ! wellchina-docs queue depth: 4 sessions · auto-cycle on reply