# Oragent

> Oragent is an Agent Supervisor: a state-aware cockpit that lets one human
> operate a fleet of independent AI coding agents (Claude Code, Codex, shell)
> from a single terminal — see which agent is working, which is waiting on
> a permission, and pre-approve the routine answers ahead of time.

## What Oragent is

Oragent is a TUI (terminal user interface) supervisor for independent AI
coding agent sessions. It uses `tmux` to host each agent in its own pane,
classifies every pane's state in real time (~6ms per capture), and routes
the operator's attention to whichever session is currently blocked.

It is **not** a multi-agent orchestrator like LangGraph, AutoGen, or CrewAI:
agents do not talk to each other through Oragent. The human is the sole
router. The mental model is "one operator, many agents" — like an air
traffic controller, not a factory line.

## Status alphabet — the entire vocabulary

Every session is in exactly one of seven states. No DAGs, no workflows,
no SDLC gates.

- **WORKING** — agent is producing output
- **WAITING** — blocked on operator permission
- **IDLE** — finished, awaiting next prompt
- **AUTO** — Auto Pilot is answering for the operator
- **SHELL** — interactive shell session
- **STOPPED** — process exited
- **UNKNOWN** — reconciling (transient)

## Three things Oragent does

1. **Reads each agent's state.** Pane-level pattern matching classifies
   every session into one of the seven states. Typical capture cost ~6ms.
2. **Pre-approves the permissions you'd say yes to anyway.** Per-session
   Auto Pilot answers routine permission prompts automatically. Real
   judgment calls still come through to the operator.
3. **Routes WAITING to the front of your attention.** When any session
   blocks on a permission, Oragent moves focus there via a FIFO queue.

## Install

```
pipx install oragent
```

Runtime: Python ≥ 3.11, tmux. Platforms: macOS, Linux (Windows next).
License: MIT.

## Key links

- [Homepage](https://oragent.org/)
- [GitHub repository](https://github.com/oragent-ai/oragent)
- [PyPI package](https://pypi.org/project/oragent/)
- [Issue tracker](https://github.com/oragent-ai/oragent/issues)
- [Latest release](https://github.com/oragent-ai/oragent/releases/latest)
- [MIT license](https://opensource.org/license/mit)

## About the name

Oragent — pronounced "or-AY-jent" — a contraction of "operator" + "agent".
Note: unrelated to *Oragenics* (OGEN), a biopharmaceutical company.

## Author

Built by Shuangrui Chen (陈双瑞).