Long-running agent work that can plan, execute, verify, pause, and continue beyond a single model turn.
Preview v0.1.1 · Official open-source release on the way.
Website · Video Demo · Technical Report · arXiv:2608.05144 · WeChat Community · English / 简体中文
Manager → Planner → Engineer ⇄ Reviewer
Most agents are optimized for one conversation or one coding turn. Argus is built for work that lasts: it keeps state, separates execution from judgment, and resumes from verified progress instead of starting over.
| Capability | What it means |
|---|---|
| Persistent state | Tasks, checkpoints, decisions, Skills, and evidence survive sessions and runtime upgrades. |
| Independent review | Execution and verification stay separate; normal rounds end with a Reviewer judgment. |
| Four-role runtime | Manager, Planner, Engineer, and Reviewer have distinct authority and responsibilities. |
| Real tool use | Agents work through files, terminals, experiments, APIs, and inspectable artifacts. |
| Domain extensibility | Verticals can define custom stages, tools, evidence requirements, and completion standards. |
| Multiple backends | Run with GitHub Copilot CLI, Pi, Codex CLI, Claude Code, or OpenCode. |
| Authority | Responsibility | |
|---|---|---|
01 |
Manager · Control | Interprets operator intent, selects the workflow, and owns stage transitions. |
02 |
Planner · Direction | Chooses the next high-value task and defines the evidence it must produce. |
03 |
Engineer · Execution | Implements, researches, runs experiments, and creates inspectable artifacts. |
04 |
Reviewer · Verification | Independently checks correctness, evidence, limitations, and completion. |
A project can stop, resume, survive a runtime replacement, and continue from its latest verified position.
Native backends: GitHub Copilot CLI · Pi · OpenAI Codex CLI · Claude Code · OpenCode
- Python 3.11+
- Node.js 22+
- One supported Agent CLI installed and authenticated through its official login flow
git clone https://github.com/lbx154/Argus.git
cd Argus
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
pip install -e .argus --setup --non-interactive \
--backend copilot \
--accept-house-rulesUse copilot, pi, codex, claude, or opencode for --backend.
argusargus --doctor # verify the installation
argus --status # inspect the current runtimeargusUse the terminal cockpit to talk to the Manager, follow live work, inspect state, and resume projects.
Start Argus and open the Web UI in your default browser:
argus --webDefault address: http://127.0.0.1:8799
argus --web --no-open # start without opening a browser
argus --web --port 8800 # use another portOn the server:
argus --web --no-openOn your computer:
ssh -L 8799:127.0.0.1:8799 user@serverThen open http://127.0.0.1:8799 locally.
Direct LAN access
Direct LAN access must be protected by a bearer token:
export ARGUS_SKILL_WEB_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"
printf '%s\n' "$ARGUS_SKILL_WEB_TOKEN"
argus --web --host 0.0.0.0 --port 8799 --no-openOpen the URL below from another machine, replacing the host and token:
http://SERVER_IP:8799/?token=YOUR_TOKEN
Never expose 0.0.0.0 without ARGUS_SKILL_WEB_TOKEN.
Argus is designed to be changed, not merely configured.
If you are an agent enthusiast, deploy Argus locally and make the complete loop fit the way you work. Tune role prompts, workflow boundaries, review policy, tools, and operating conventions; connect your own infrastructure; preserve the behavior you care about with tests.
A Vertical gives your field its own stages, Skills, datasets, tools, evidence expectations, evaluation methods, and completion criteria. Planning and review can then follow the real standards of your domain instead of a generic process.
GitHub Copilot, Pi, Codex, Claude Code, OpenCode, OpenClaw, or Hermes can be the environment from which you invoke Argus, inspect its state, operate its local CLI or Web/API surface, and continue improving the deployment.
- Native Argus backends: GitHub Copilot CLI, Pi, Codex CLI, Claude Code, OpenCode
- External agent operators: OpenClaw, Hermes, or any agent that can use a shell or HTTP API
Useful entry points:
argus --doctor
argus --status
argus --web --no-openThe most capable setup is often an Argus instance deliberately adapted to your own ambitious field and way of working.
cd Argus
git pull --ff-only
.venv/bin/python -m pip install -e .
.venv/bin/argusArgus detects stale local WebAPI and daemon processes and replaces them at a controlled task boundary.
Scan the QR code below to join the Argus community. The expiry date is printed in the image; if it has expired, open an Issue and ask the maintainers for the latest code.
