python
Python 3.11+ tests and static checks: pytest, ruff, and mypy.
Retornatus
Install once in your project. Your agent works toward a clear outcome, remembers across chats, and cannot call work “done” without evidence you can see.
Your coding agent still writes the code. Retornatus governs the loop and keeps the record. Deep mechanics live in the docs.
Govern the work. Bound the agent. Verify the outcome. Demand what you need, agree on what “done” means, execute, then verify with proof that stays in git — so every return to the project is informed, not amnesiac.
retornatus init --preset writes a starting config from a file shipped in the package.
verify checks that the named commands ran and exited 0. It does not grade the tests, the deploy plan, or the eval set.
Python 3.11+ tests and static checks: pytest, ruff, and mypy.
Extends python. Ship and AI rules run when deploy files or model paths change.
Extends python-platform. API layout globs. Alembic paths count as ship.
Extends python-platform. Django layout globs. Migration paths count as ship.
Extends python-platform. Retrieval and prompt globs, with a stronger AI surface.
Extends python-platform. Task and queue globs. Task code counts as ship and needs a retry note.
retornatus init --list-presets
retornatus init --preset fastapi
Ship means Docker, Compose, Terraform, Helm, or a workflow file.
With worker, task, schedule, and queue files count as ship too.
AI means prompts, evals, MCP, or retrieval code.
If those paths are not in the Change, the extra rule is not required.
An existing config stays put unless you pass --force-config.
Presets guide.
uv tool install retornatus
cd /path/to/your-app
retornatus init
retornatus integrate
retornatus doctor
Needs Python 3.11+ ·
uv recommended ·
also on PyPI.
Then open the project in your AI coding agent and start a change.
On a pull request, the GitHub Action posts one sticky verdict comment.
integrate --hooks can inject the active Change at session start and keep the turn open until that Change is SATISFIED.
That hook is a guardrail. The pull-request check stays the source of truth.
Agent hooks.
Highlights from 1.9.1, including the subagent-stop hook, the scope warning hook, the SessionStart hook, agent hooks, and init presets.
retornatus hook subagent-stop reminds a Cursor, Claude Code, or Codex subagent when the active Change is not SATISFIED. [hooks] subagent_stop defaults to true.retornatus hook file-edit warns when an edit leaves the active Change scope. [hooks] scope_mode is warn, block, or off.retornatus hook session-start injects the active Change when a Claude Code, Cursor, or Codex session starts. integrate --hooks installs it beside the Stop hook.retornatus hook stop and integrate --hooks for Claude Code, Cursor, and Codex. The turn stays open until the active Change is SATISFIED. CI stays the source of truth.python, python-platform, fastapi, django, rag, and worker. Ship and AI rules run only when those paths change, and they check that the command ran.verify --receipt; anyone can check it with the committed public key (receipt verify). The private key stays outside the repo.action budget / gate budget.CREATE=yes.Release notes and technical depth: documentation · releases.