Docs
AWOS documentation
AWOS is a background coding agent that runs on your own machine. You queue small, well-defined tickets; a local worker takes them one at a time, works in a separate copy of your repo, checks the result, and leaves a local review branch with a short report.
Start here
QuickstartFrom a ticket to a review branch in five commands.
ConceptsJobs, workspaces, verification, review branches and blocked jobs.
Models and costCloud or local models, budgets, and what tickets cost.
CLI referenceEvery flag for the commands you use day to day.
Security and privacyWhat runs where, what leaves your machine, and the guards.
FAQShort answers to the common questions.
The workflow in one picture
- Queue.
awos submit --repo . "GOAL"adds a job with a dollar cap to a local queue. - Run.
awos serve --workertakes queued jobs one at a time. - Isolate. Each job works in its own git worktree at your current commit.
- Verify. The worker runs your tests in that workspace and checks the result against the goal.
- Hand off. The diff becomes a local branch
awos/<id>withreport.md. Nothing is pushed. - Review.
awos status --digestshows what finished, what is blocked, and what was spent today.
AWOS is in early access. Request access to get the install command.