$ About
What is Ferrus
Ferrus is a deterministic orchestrator for AI coding agents. It drives a Supervisor → Executor → Reviewer state machine so agents like Claude Code, Codex, Qwen Code, goose, and opencode can carry out real software tasks through explicit, inspectable transitions instead of an open-ended chat.
Philosophy
Agents should be workers, not oracles.
Ferrus keeps runtime state in SQLite and task context in plain scoped Markdown files under .ferrus/tasks/ and .ferrus/runs/, so humans and agents operate on the same source of truth. No hidden context, no implicit memory, no magic.
Why deterministic
Real software work needs repeatability.
Explicit state transitions, retries, and review cycles make execution auditable, resumable, and crash-safe. If a run is interrupted, the next invocation resumes exactly where the previous one stopped — because the state lives in ferrus.db, not in an agent's head.