Run the system

Keep the work
moving safely.

The CLI is deterministic. The supervisor supplies planning and judgment. Together they make a repeatable loop any local runtime can join.

Install

python -m pip install --no-deps .
useagent --help
useagent validate

An installed command uses the current directory as its root. A central checkout can target a prepared repository with useagent --root F:\dev\DemoStore ....

Worker loop

01python tools/useagent.py supervisor cycle

Ingest reports and dispatch ready tasks.

02python tools/useagent.py worker pull --agent <id>

Move the oldest assignment into progress.

03python tools/useagent.py task report <id> ...

Write a report, evidence and next action.

04python tools/useagent.py supervisor cycle --run-qa

Review the handover, run QA and checkpoint.

Autopilot cycle

Every cycle is bounded. It stops for ambiguity, missing access, scope conflicts, repeated failures or unsafe side effects. A scheduler may invoke the next cycle later; the CLI never creates an infinite self-loop.

Read these files first

work/SUPERVISOR_REPORT.md for health and next action; work/checkpoints/ for resume context; work/evidence/ for reproducible output.

Vận hành bằng tiếng Việt

Worker chạy pull trước khi sửa, chỉ làm trong scope đã claim, sau đó report task id, file đã chạm, command/evidence, blocker và next action. Supervisor chạy cycle hữu hạn để ingest, QA, review và giao việc tiếp theo.

Open the repository