# ouroboros

> Stop prompting. Start specifying.

- **URL**: https://www.freshcrate.ai/projects/ouroboros
- **Author**: Q00
- **Category**: MCP Servers
- **Latest version**: `v0.40.1` (2026-05-30)
- **License**: MIT
- **Source**: https://github.com/Q00/ouroboros
- **Language**: Python
- **GitHub**: 2,576 stars, 233 forks
- **Registry**: github
- **Tags**: `ai-agent`, `claude-code`, `codex-cli`, `devtools`, `evaluation`, `llm`, `mcp`, `multi-agent`, `prompt-engineering`, `python`

## Description

Stop prompting. Start specifying.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.40.1` | 2026-05-30 | High | ## What's Changed  ### Bug Fixes - Include `click` as an installer runtime dependency (#1299)  **Full Changelog**: https://github.com/Q00/ouroboros/compare/v0.40.0...v0.40.1   ## What's Changed * fix(installer): include click runtime dependency by @Q00 in https://github.com/Q00/ouroboros/pull/1299   **Full Changelog**: https://github.com/Q00/ouroboros/compare/v0.40.0...v0.40.1 |
| `v0.40.0` | 2026-05-30 | High | # v0.40.0 — `ooo auto` crosses the line  > **This is the release where `ooo auto` stops being a demo and becomes a machine that finishes your work.**  You drop in a vague intention. The Socratic interview pins it down into a precise, machine-checkable goal — and then the engine refuses to stop until that goal is actually **built, verified, and shipped**. No babysitting. No "it drew up a plan and gave up halfway." The loop owns the outcome, end to end.  This is not "generate a plan." This is **go |
| `v0.39.1` | 2026-05-20 | High | ## What's Changed  ### Features - Add `ouroboros status run --json` projection surface (#1133) - Record durable workflow lifecycle events in orchestrator (#1134) - Add `on_error`/`on_cancel` plugin observability hooks (PR E) (#1137) - Expose MCP interview reasoning metadata (#1140) - Prompt for required trust grants on plugin install (#1141) - Expose Ralph-start alias while preserving runtime ownership - Dispatch lifecycle hooks within plugin trust boundaries - Make plugin permission waits share |
| `v0.39.0` | 2026-05-18 | High | ## Ouroboros v0.39.0  This release lands a high-severity **security fix**, flips `ooo run` to the fat-harness execution path by default, and completes the AgentOS roadmap wiring/baseline milestone tracked in [#961](https://github.com/Q00/ouroboros/issues/961).  ## 🔒 Security  ### RCE via untrusted project-directory `.env` (high severity)  Ouroboros is run *inside cloned repositories*. `config/loader.py` loaded `./.env` from the working directory into `os.environ` at import time with the **same |
| `v0.38.2` | 2026-05-13 | High | ## What's Changed  ### Bug Fixes - Close residual `allowed_tools=[]` leak in sub-CLI envelope for interview  ### Testing - Lock empty `allowedTools` passthrough - Cover strict empty allowed-tools envelope (#975)  **Full Changelog**: https://github.com/Q00/ouroboros/compare/v0.38.1...v0.38.2   ## What's Changed * fix(interview): close residual allowed_tools=[] leak in sub-CLI envelope by @Q00 in https://github.com/Q00/ouroboros/pull/974   **Full Changelog**: https://github.com/Q00/ouroboros/compa |
| `v0.37.0` | 2026-05-11 | High | ## What's Changed  ### Features  #### `ooo auto` Pipeline - `DomainProfile` and `VerifiablePredicate` contracts (#849, #809 P3 PR 1/6) - `UNSTUCK_LATERAL` persona advisor on EVALUATE fail (#829) - EVALUATE phase verifies run output against seed AC (#825) - Formalize run-handoff idempotency contract (#843) - Chain RUN→RALPH automatically with `--complete-product` (#791) - `user_preference` source + deterministic ambiguity floor (#811) - Top-level `pipeline_timeout_seconds` deadline (#790) - Steer |
| `v0.34.0` | 2026-05-06 | High | ## What's Changed in v0.34.0  ### Features - **Copilot CLI runtime** (#1f07a9c8) — first-class Copilot agent runtime - **Kiro runtime backend** (#2fc7a3c8) — Kiro as a first-class runtime - **Stage enum + runtime_profile.stages config** (#538) — slice 1 of #519 - **Agent OS runtime_profile (Codex backend)** (#505) — runtime profile foundation - **AgentProcess lifecycle projection** (#628) — project lifecycle state from events - **Directive emission at StepAction sites** (#477464ef) — slice 1 of |
| `v0.31.1` | 2026-04-29 | High | ## What's Changed * fix(parallel): honor configured worker caps by @andrew-adamson in https://github.com/Q00/ouroboros/pull/489 * feat(orchestrator): Gemini CLI runtime backend (follow-up to #312) by @shaun0927 in https://github.com/Q00/ouroboros/pull/504 * fix(router): preserve Windows literal path payloads through skill dispatch by @shaun0927 in https://github.com/Q00/ouroboros/pull/481 * fix(brownfield): scan repos with any origin remote by @andrew-adamson in https://github.com/Q00/ouroboros/ |
| `v0.30.0` | 2026-04-26 | High | ## What's Changed  ### Features - **CLI**: add `ooo resume` to recover in-flight sessions after MCP disconnect (#433) - **MCP**: add streamable HTTP serve transport - **MCP**: add compact monitoring relay views - **MCP**: suggest lateral persona from stagnation - **Resilience**: add in-run lateral recovery - **Events**: add `control.directive.emitted` event factory - **Core**: introduce `Directive` StrEnum for control-plane decisions  ### Bug Fixes  **MCP** - clarify job wait execution progress |
| `v0.29.2` | 2026-04-22 | High | ## What's Changed  ### Bug Fixes - fix(mcp): protect startup stdin during shell env loading (#482) - fix(interview): guard seed-ready closure (#484) - fix(evaluate): replace language presets with AI-driven mechanical.toml (#454)  **Full Changelog**: https://github.com/Q00/ouroboros/compare/v0.29.1...v0.29.2   ## What's Changed * fix(evaluate): replace language presets with AI-driven mechanical.toml by @Q00 in https://github.com/Q00/ouroboros/pull/454 * fix(interview): guard seed-ready closure by |

## Citation

- HTML: https://www.freshcrate.ai/projects/ouroboros
- Markdown: https://www.freshcrate.ai/projects/ouroboros.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ouroboros/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._