DOS (dos-kernel)
DOS (Dispatch Operating System) is a Python package that verifies whether AI coding agents actually shipped the work they claim, by checking git history and other artifacts instead of trusting the agent's report. It solves the problem of agents falsely reporting completion, especially in fleets, and is for developers running AI agents on git repositories.
✨ Key features
- Verifies agent claims against git history with
dos verify. - Returns SHIPPED (exit 0) or NOT_SHIPPED (exit 1) verdicts.
- Detects collisions between agents editing the same files.
- Flags stalled runs that spin without progress.
- Works on plain git repos with zero config.
- Only runtime dependency is PyYAML.
🎯 Use cases
- Gate CI steps on real shipped work instead of agent claims.
- Audit commits to see if each claim is backed by its diff.
- Run fleets of agents with collision detection and arbitration.
- Residual review: prioritize human review on commits git can't back.
📦 Installation
🧰 Requirements: Python 3.11–3.13 on Linux or Windows (smoke), with PyYAML as the only runtime dependency.
cd path/to/your-repo
pip install dos-kernel
dos init --hooks auto # detects the agent runtime(s) already in this repo
dos doctor # shows exactly what this workspace is using
🚀 Usage
dos verify AUTH AUTH1 # → SHIPPED AUTH AUTH1 e62f74d (exit 0)
dos verify AUTH AUTH2 # → NOT_SHIPPED AUTH AUTH2 (exit 1)
⚠️ Good to know
DOS tells you what happened, not whether the code is good; quality remains with your tests and reviews.
❓ FAQ
How does DOS verify an agent's claim?
It reads git history and other artifacts (file tree, clock) to see if a commit backs the claim, ignoring the agent's narration.
What does the exit code mean?
Exit 0 means SHIPPED (claim backed by a commit), exit 1 means NOT_SHIPPED (no commit found).
Do I need to configure anything?
No, it works on a plain git repo with zero config. You can run dos init --hooks auto to detect agent runtimes.
Can I try it without installing?
Yes, run uvx --from dos-kernel dos quickstart for a 60-second demo in a throwaway repo.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.