kaos-control 0.1.3
kaos-control 0.1.3 — Release Notes
Changes since v0.1.2 (2026-05-18).
This release focuses on visibility into agent work, first-class release planning,
faster idea capture, and a UI that works on phones.
Codex CLI drivers and Devcontainer support contributed by Tim Preston @tmpreston.
New features
📊 Agent usage report (new "Reports" view)
A new Reports page breaks down agent-run cost, token usage, and time-to-first-token
— overall and per-model / per-agent — with date-range filtering and CSV export.
Metrics are captured automatically as runs finish. (See upgrade notes to populate
it from existing history.)
🗓️ Releases as first-class artefacts
Releases are now markdown artefacts under lifecycle/releases/, editable in the UI
and synced to disk, with live updates over WebSocket and a new unscheduled
state. They surface in the Roadmap, with a "rehydrate from disk" action in the
toolbar.
⚡ Faster idea capture & auto-triage
A single-submit "brain dump" capture mode lets you get an idea down in one step.
New ideas land in a pre-draft raw status, and an auto-triage step promotes them
into proper drafts — manually via a Triage now button, or automatically on file
changes and at startup.
📱 Mobile-responsive UI
Below 640 px the sidebar becomes a slide-in drawer with a hamburger toggle, data
tables scroll horizontally, modals go full-screen, key views reflow, and the graph
renders in 2-D with a slide-in filter panel.
🤖 New agent drivers: Codex CLI and Gemini
Three new agent drivers, all selectable in the agent config form alongside the
existing Claude and Ollama drivers:
gemini— Google Gemini models via the Gemini API (setGEMINI_API_KEY).gemini-cli— drives theagyGemini CLI as an autonomous agent.codex-cli— runscodex exec.
📚 Documentation panel
A new Documentation view lists the project's docs/ files and renders them in
app: markdown as a formatted preview, HTML in a sandboxed iframe, and images
inline. Markdown docs are editable in place (sha-checked saves with live
doc.changed updates); reachable from the sidebar's Documentation entry.
🧭 Sidebar navigation overhaul
The sidebar can now collapse to an icon-only rail with tooltips, and its items are
grouped into four functional sections — Activity / Content / Automation / System.
Developer experience
🧰 VS Code / Codespaces dev container
A new .devcontainer/ gives contributors a one-step environment (Ubuntu 24.04)
with Go, Node, pnpm, Claude Code, Codex, and Delve pre-installed. On create it
bootstraps a local kaos-control config + project entry (pointing at the
checked-out repo, so it shows up in the project picker) and forwards the Vite
(5173) and server (8080) ports.
Reliability & performance
- Queue rate-limit handling: auto-pause and retry on Anthropic 529 "overloaded"
and HTTP 429, with a shorter pause for transient overload; internalapi_retry
events are now shown in the run log. - Truncated agent runs: runs that exit cleanly without a terminal result event
are correctly flagged as failed rather than silently passing (plus a follow-up
fix so healthy runs are no longer mis-flagged). - Frontmatter parsing: markdown files with no frontmatter are now skipped
informationally instead of raising parse errors.
Bug fixes
- Idea triage: coalesce duplicate in-flight runs on lock conflict; suppress
improper retries via a cooldown; resolve symlinked project roots; return
409 wrong_typeinstead of404for non-idea slugs. - Roadmap Gantt: fixed a last-day end-date off-by-one that clipped bars.
- Releases: broadcast
release.created/release.updated; normalise symlink
paths so API-driven writes don't double-fire watcher events. - Gemini CLI driver: pass
--add-dirand--print-timeout; unwedge the
supervisor when the CLI detaches a daemon child. - Agent runs: backfill missing
parent:frontmatter on child artefacts. - Project init: removed a duplicate
kanbanblock that broke config loading on
freshly-initialised projects. - API: expose the
artifactskey in the list-artifacts response. - Agent config form: show a
GEMINI_API_KEYhint for the Gemini driver.
Upgrade notes
- Populate the Reports view from history: metrics are recorded for new runs
automatically, but past runs need a one-time backfill (per project):Safe to run with the server up, and safe to re-run.kaos-control backfill agent-run-metrics --project <id> - Dev tooling only: the frontend test stack moved to Vite 6 / Vitest 4 — no
runtime impact.