Skip to content

kaos-control 0.1.3

Choose a tag to compare

@kcsinclair kcsinclair released this 14 Jun 08:11
· 411 commits to main since this release

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 (set GEMINI_API_KEY).
  • gemini-cli — drives the agy Gemini CLI as an autonomous agent.
  • codex-cli — runs codex 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; internal api_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_type instead of 404 for 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-dir and --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 kanban block that broke config loading on
    freshly-initialised projects.
  • API: expose the artifacts key in the list-artifacts response.
  • Agent config form: show a GEMINI_API_KEY hint 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):
    kaos-control backfill agent-run-metrics --project <id>
    
    Safe to run with the server up, and safe to re-run.
  • Dev tooling only: the frontend test stack moved to Vite 6 / Vitest 4 — no
    runtime impact.