ReleaseWitness

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.

Diagram of the shared repository ledger containing knowledge, work, reports, evidence and checkpoints.
The repository is shared memory: agents read compact context before code, then leave evidence for the next supervisor cycle.

Install

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

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

Worker loop

01relwit supervisor cycle

Ingest reports and dispatch ready tasks.

02relwit worker pull --agent <id>

Move the oldest assignment into progress.

03relwit task report <id> ...

Write a report, evidence and next action.

04relwit supervisor cycle --run-qa

Review the handover, run QA and checkpoint.

Automatic worker intake

Use an explicitly configured argv adapter when you want workers to start from the mailbox automatically. worker run is bounded by task count, idle wait and runner timeout; an optional preflight must return an explicit ready state before pull. Codex, Claude Code and Antigravity keep their provider-specific launch details inside the adapter. Runner evidence is bounded and sanitized, while detailed diagnostics stay in the ignored local spool.

relwit worker run --agent <id> --max-tasks 2 --wait-seconds 300

No runner is configured by default. A runner that exits without task report is recorded as failed with evidence so the supervisor can debug it.

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