# 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: Oragent Free Use License v1.0 (closed-source, free of charge,
not OSI-approved). Full text shipped with each release as `LICENSE`;
summary at https://oragent.org/terms.

## Privacy and terms

Oragent is a local tool. There is no signup, no backend that receives your
data, no analytics on the website, no cookies set by the maintainers, and no
telemetry from the TUI. Your sessions, prompts, AI responses, API keys,
terminal contents, and screenshots stay on your machine.

The only outbound network call Oragent itself makes is a periodic read-only
HTTPS GET against `https://oragent-ai.github.io/updates/manifest.json`
(release manifest, hosted on GitHub Pages), with a fallback to
`https://pypi.org/pypi/oragent/json` (public PyPI metadata). Both are
version-discovery endpoints; no usage data is transmitted.

The software is licensed under the Oragent Free Use License v1.0
(source-unavailable, free of charge, not OSI-approved) and provided
as-is, with no warranty. The license grants installation, personal use,
and internal commercial use at no cost; it does not grant redistribution,
reverse engineering, or the right to publish forks. The operator is
responsible for what the AI agents they run inside Oragent do on their
machine — Oragent is a supervisor, not the agent. The "Oragent" name,
mark, and site content are not covered by the license grant.

- [Privacy policy](https://oragent.org/privacy)
- [Terms of use](https://oragent.org/terms)

## Support and funding

Oragent is maintained by one independent developer. It is free under the
Oragent Free Use License; there is no paid tier, no subscription, no
advertising, and no telemetry. Voluntary contributions cover the
maintainer's time.

The channel infrastructure (Stripe) is being wired up; the dedicated page
lives at `https://oragent.org/support` and lists three reference tiers in
USD: $3 (coffee), $8 (recommended), and $20, plus an "as you wish" custom
amount. In-app support — a `♥` status-line glyph and an `s` shortcut
inside the TUI — ships with Oragent v0.4.

Until then, three free things help just as much: star the GitHub
repository, share `https://oragent.org`, and file detailed issues at the
issue tracker.

## 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)
- [License (Oragent Free Use)](https://oragent.org/terms)
- [Privacy policy](https://oragent.org/privacy)
- [Terms of use](https://oragent.org/terms)
- [Support Oragent](https://oragent.org/support)

## 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 (陈双瑞).
