Repository navigation
v0.60.0: Meet the Ouroboros Console
Ouroboros v0.60.0: meet the Console
The biggest Ouroboros release yet. It adds a full web console, and the engine you already use now runs measurably faster. Every claim in the docs is now checked against the code, so the docs stay true.
✨ The Ouroboros Console: ouroboros gui
Run Ouroboros from your browser. There's no config file to edit and no flags to remember.
- It opens on its own after you install. The installer starts the console and opens your browser (#2996). Reopen it any time with
ouroboros gui. - Connect. See every agent CLI on your machine: Claude Code, Codex, OpenCode, Gemini, Copilot, Kiro, Goose, Hermes, Pi and more. Install a missing one or connect Ouroboros to it with one click.
- Chat. Interview, Auto and Ask modes. Describe what you want, and the console runs the Socratic interview, writes the spec, and hands it to your agents. It shows live tiles for each acceptance criterion and the changed files at the end.
- Agents & models, Providers, Health. Pick the agent and model for each stage, add LiteLLM provider keys, and fix a broken install from one page.
- Shared MCP. Optionally run one MCP server for all your tools instead of one per session.
- The details. Light and dark themes, five languages (English, 한국어, 中文, 日本語, Español), keyboard-first (⌘K), and about 245 KB of assets in the wheel. It binds to 127.0.0.1 only, with a per-start token.
Shipped in #2993. The README is now a five-minute read (#2994), and the deep dives moved to How Ouroboros works.
⚡ Faster where you wait
A full audit of the hot paths turned up 26 fixes (#2928). Each one is proven to behave exactly as before, and each saving is measured:
| What | Before | After |
|---|---|---|
| Session activity snapshot (3,000 sessions) | 47 s | 107 ms |
| Evidence claim verification (1,800 messages) | 54 s | 3.5 s |
| Delivery gate per acceptance criterion (8k events) | 2.5 s | 22 ms |
| Leaf tool-call lookup | 2.8 s | 3 ms |
ouroboros --version |
1.8 s | 0.32 s |
config.yaml parses during ouroboros config show |
131 | 1 |
| Event-loop stall during boundary checkout copies | 4–9 s | 0.1 s |
Rows read per job_wait poll |
20,505 | 503 |
| Idle MCP server started by each Claude worker | 2 processes, about 207 MB | none (#2990) |
| Code the welcome skill makes your agent retype per run | 8.3 KB | 1.4 KB (#2978) |
📚 Docs that can't quietly go stale
Docs drift now fails the PR that causes it (#2921):
- Checked on every PR: CLI commands and flags, config keys,
OUROBOROS_*variables, MCP tool and agent names, and repository paths in the docs. These checks run in the required test job. - Generated from code: the
llms.txt/llms-full.txtcatalogs, so AI agents reading them see every command, skill and tool. - Mapped to the code:
docs/doc-map.ymllinks source files to the docs that describe them, and an advisory check flags docs a PR may have forgotten. - Already fixed: 8 CLI commands that had no reference section, 46 config keys that were missing, and the dead paths and variables the checks found.
🛠 Fixes worth knowing
- Non-English macOS locales: PID-reuse protection works again. It was silently disabled when
psprinted localized dates (#2947). - macOS system Python: the SessionStart hook no longer crashes on Python 3.9 (#2937), and the update check now backs off instead of costing 5 s per session (#2948).
- Test runs: they no longer leave git worktrees behind in your checkout (#2956).
Install or upgrade in one line
The same command installs Ouroboros fresh or upgrades an existing install, and it keeps your configuration. When it finishes, the console opens in your browser.
# macOS / Linux / WSL 2
curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | bash# Windows (PowerShell 5.1+ or pwsh 7+)
irm https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.ps1 | iexAlready set up? ouroboros update (or ooo update inside your agent) works too. Then run ouroboros gui.
Thank you to everyone who filed issues and tried early builds. ⭐ If Ouroboros saves you time, a star helps others find it.
What's Changed
- feat(verifier): bind wrapper test receipts to accepted Bash attempts by @lee3Q in #2745
- feat(examples): outcome record and disagreement core for example questions by @Q00 in #2773
- feat(examples): probe wrapper and runner for example questions by @Q00 in #2774
- docs(readme): align runtime demos in a scrollable row by @lee3Q in #2776
- fix(runtime): bound Pi and OMP completion waits by @Q00 in #2781
- fix(gemini): retain reported completion token counts by @Q00 in #2791
- fix(gemini): parse multiline batch response usage by @sergiobuilds in #2802
- fix(config): reject invalid boolean CLI values by @zittenyetten in #2764
- docs: align PAL Router and Phase 2 descriptions with live code by @mimpp92-dotco in #2770
- fix(qa): validate numeric thresholds against the score scale by @Q00 in #2780
- fix(evaluation): discover unittest files using Python source encodings by @Q00 in #2784
- fix(evaluation): account for unittest load_tests discovery hooks by @Q00 in #2782
- fix(gemini): preserve native assistant text deltas by @Q00 in #2790
- test: stabilize job lifecycle fixtures and CLI output assertions by @zittenyetten in #2796
- fix(mcp): bind detached rejections to the exact launch by @zittenyetten in #2798
- fix(mcp): persist pending acceptance observations for job reads by @zittenyetten in #2800
- fix(providers): unwrap Anthropic JSON schema format metadata by @Q00 in #2792
- fix(anthropic): retain additive cache token usage by @Q00 in #2793
- fix(providers): report native CLI completion usage by @Q00 in #2794
- fix(antigravity): retain streamed answer after empty terminal response by @Q00 in #2767
- fix(cli): handle unreadable OpenCode config without aborting integration changes by @Q00 in #2777
- fix(context-pack): refresh cached facts after timestamp-preserving edits by @Q00 in #2779
- fix(context-pack): enforce the display budget for all facts by @Q00 in #2778
- fix(context-pack): read tab-separated Go declarations by @Q00 in #2789
- fix(tui): preserve tree navigation during live refreshes by @Q00 in #2785
- fix(tui): synchronize selected node activity details by @Q00 in #2786
- fix(reports): align warning paths with actual task numbers by @Q00 in #2788
- fix(update): preserve literal paths in dry-run previews by @Q00 in #2787
- fix(evaluation): tolerate overflowing timeout configuration values by @Q00 in #2783
- chore(deps): bump the python-minor-patch group across 1 directory with 4 updates by @dependabot[bot] in #2765
- chore(deps-dev): bump mcp from 1.28.1 to 2.3.0 by @dependabot[bot] in #2766
- fix(verify): bind per-AC verification working directories by @Q00 in #2196
- feat(runtime): add explicit Copilot ACP execution and durable diagnostics by @sergiobuilds in #2805
- feat(interview): retain bounded calibration across runtime turns by @sergiobuilds in #2804
- feat(megacode): add the megacode harness runtime and LLM backend by @Q00 in #2762
- fix(evidence): reject malformed terminal payloads without reviving stale evidence by @sergiobuilds in #2803
- fix(cli): decode seed YAML as UTF-8 by @lee3Q in #2847
- fix(context): decode source independently of locale by @lee3Q in #2846
- fix(models): read default model hints as UTF-8 by @lee3Q in #2860
- fix(evaluation): reject malformed semantic scores by @lee3Q in #2842
- fix(config): preserve Undo backups when settings saves fail by @zittenyetten in #2823
- fix(providers): wrap bare JSON schema for LiteLLM response_format by @Laihu08 in #2818
- fix(boundary): preserve checkout data during retries and publication by @sergiobuilds in #2910
- fix(providers): omit sampling for OpenAI reasoning models by @lee3Q in #2819
- fix(config): read mcp.yaml and custom agent files as UTF-8 by @ppcvote in #2821
- fix(tests): isolate inherited Codex configuration by @lee3Q in #2837
- fix(core): decode Git output as UTF-8 instead of the process code page by @PerryLink in #2918
- fix(status): avoid exposing credential parser errors by @lee3Q in #2857
- test(auto): stop auto tests registering worktrees in the checkout by @Q00 in #2956
- fix(config): keep CLI saves in Undo history by @zittenyetten in #2912
- fix(auto): keep checkpoint commits working when Git prints non-UTF-8 paths by @PerryLink in #2919
- test(canonical): consolidate artifact and live-fixture guards by @sergiobuilds in #2967
- docs: consolidate setup, recovery and Korean runtime guides by @sergiobuilds in #2969
- feat(maintenance): report open issues with merged PR references by @lee3Q in #2838
- refactor(orchestrator): extract process-local authority lifecycle by @lee3Q in #2824
- fix(runtime): consolidate direct request model overrides by @sergiobuilds in #2970
- fix(evaluation): reject disguised and ambiguous coverage evidence by @sergiobuilds in #2974
- fix(config): redact credential and health validation errors by @sergiobuilds in #2968
- fix(config): align saved runtime choices and warn on inactive keys by @sergiobuilds in #2975
- fix(uninstall): preserve unrelated UTF-8 and OpenCode plugin entries by @sergiobuilds in #2979
- chore(deps): update Python and uv setup actions by @sergiobuilds in #2980
- fix(examples): settle owned copy tasks before cleanup by @sergiobuilds in #2981
- fix(interview): reject stale saves and honor question-only hosts by @sergiobuilds in #2985
- fix(boundary): preserve workspace ownership and refuse uncertain scans by @sergiobuilds in #2976
- fix(runtime): preserve uncertain cleanup and completed execution evidence by @sergiobuilds in #2984
- fix(verification): refuse incomplete and non-executing evidence by @sergiobuilds in #2973
- feat(interview): consolidate opt-in structured interviews and material references by @sergiobuilds in #2988
- fix(qa): persist verdicts in the owning session store by @sergiobuilds in #2977
- fix(doctor): protect local probe startup and cleanup diagnostics by @sergiobuilds in #2983
- fix(deps): preserve target extras while upgrading Claude dependencies by @sergiobuilds in #2982
- fix(mcp): preserve accepted detached execution policy and receipts by @sergiobuilds in #2986
- docs(contributing): add docs freshness policy by @Q00 in #2922
- docs: move dated plans and handoffs into docs/history by @Q00 in #2925
- test(docs): fail when docs name OUROBOROS_* variables nothing reads by @Q00 in #2923
- test(docs): fail when maintained docs name missing repository paths by @Q00 in #2924
- test(docs): fail when docs name unregistered MCP tools or missing agents by @Q00 in #2926
- test(docs): bind config-reference.md keys to the config models by @Q00 in #2927
- test(docs): bind cli-reference.md to registered CLI commands and flags by @Q00 in #2929
- docs(llms): generate the command and MCP tool catalogs in llms.txt by @Q00 in #2932
- perf(mcp): look up the called tool's definition by name by @Q00 in #2930
- perf(boundary): parse base test imports once per pinned base by @Q00 in #2931
- perf(mcp): skip job_wait history replay when a page has no relay source by @Q00 in #2934
- perf(boundary): pair non-Python base tests in one manifest pass by @Q00 in #2935
- perf(evidence): compare the claimed path before scanning for success by @Q00 in #2936
- fix(hooks): keep hook scripts importable on Python 3.9 by @Q00 in #2937
- perf(mcp): skip re-reading progress window when no progress row landed by @Q00 in #2938
- perf(evidence): set-based Git-ignored lookup in workspace path collection by @Q00 in #2939
- perf(verify): prune ignored directories while locating the Node manifest by @Q00 in #2940
- perf(harness): index accepted tool-call correlation once per manifest by @Q00 in #2941
- perf(persistence): compute session activity snapshots with index probes by @Q00 in #2942
- perf(boundary): clean regression-check copies off the event loop by @Q00 in #2943
- perf(orchestrator): index tool-call names once per leaf stream by @Q00 in #2944
- perf(config): reuse the parsed config.yaml while its bytes are unchanged by @Q00 in #2945
- perf(heartbeat): cache this process's start time instead of spawning ps by @Q00 in #2946
- fix(heartbeat): read ps start times under the C locale by @Q00 in #2947
- perf(hooks): stop SessionStart from blocking on an unreachable PyPI by @Q00 in #2948
- perf(persistence): use the event-type index for typed execution queries by @Q00 in #2949
- perf(cli): import subcommand modules only when the subcommand runs by @Q00 in #2950
- perf(mcp): read only lifecycle rows when checking session acceptance by @Q00 in #2951
- perf(evaluation): resolve DEFAULT_SEMANTIC_MODEL on first access by @Q00 in #2952
- perf(mcp): fold only new job rows in wait_for_change by @Q00 in #2953
- perf(boundary): run package-check copies and manifests off the event loop by @Q00 in #2954
- perf(boundary): hash and snapshot checkouts off the event loop in run wiring by @Q00 in #2955
- perf(orchestrator): read each session row once in reconstruct_session by @Q00 in #2957
- perf(skills): run welcome's readiness checks from bundled scripts by @Q00 in #2978
- fix(orchestrator): stop Claude workers starting the ouroboros plugin MCP by @Q00 in #2990
- chore: reconcile docs checks and tests for the v0.60.0 batch by @Q00 in #2997
- ci(docs): advisory doc-impact summary from docs/doc-map.yml by @Q00 in #2933
- feat(gui): add the Ouroboros web console (ouroboros gui) by @Q00 in #2993
- docs(readme): simplify the READMEs and show the new console by @Q00 in #2994
- feat(install): start the Ouroboros console when installation finishes by @Q00 in #2996
- chore(release): prepare v0.60.0 by @Q00 in #2998
New Contributors
- @mimpp92-dotco made their first contribution in #2770
- @Laihu08 made their first contribution in #2818
- @ppcvote made their first contribution in #2821
Full Changelog: v0.59.9...v0.60.0
