Run a team of AI agents.
Sandboxed. Recorded. Learning.

$ pip install 'kaos-harness[all]' && kaos init
$ kaos parallel \
    -t fix    "double-charges on timeout retry — fix with an idempotency key ..." \
    -t tests  "pytest tests proving the key is generated once and reused ..." \
    -t review "security-review beyond the retry bug ..."

Agent fix (ok)    Agent tests (ok)    Agent review (ok)

$ kaos query "SELECT a.name, t.tool_name, COUNT(*) FROM agents a
    JOIN tool_calls t ON t.agent_id=a.agent_id GROUP BY 1,2"
fix     fs_write x1   tests  fs_read x1, fs_write x1   review  fs_mkdir x1, fs_write x1

$ ls                        # your working directory: untouched
kaos.db  kaos.yaml  payments.py

$ kaos read <fix> /src/payments.py > payments.py
$ kaos read <tests> /tests/test_payments.py > tests/test_payments.py
$ pytest tests/ -q
6 passed in 0.09s          # agent tests, green against the agent fix

# sprints later: 17 skill outcomes, 6 recalls, 12 hebbian edges of telemetry
$ kaos dream consolidate --apply
{ "promoted": 1, "pruned": 1, "applied": 2 }

# the 6×-retrieved lesson became a skill; the 1/6 flaky skill is hidden:
$ kaos skills search "deploy service"
deploy-canary-checklist     # only the one that actually works (5/5)

$ kaos memory search "timeout retry"
payment-retry-idempotency → "client timeout != server failure. Fix =
Idempotency-Key generated once per logical charge, reused across retries."

# an earlier run of this same session — one agent stalled:
$ kaos logs 01M1FG26...
agent_fail | {"error": "claude produced no output for 60.0s"}

# exact cause on the record → became the 2.0.2 agent_sdk fix
# (isolated in-process sessions — no CLI contention, no stalls).
# and the one recall miss we hit is filed, with a probe sketch:
$ kaos memory search "duplicate processing"
no match   # FTS is literal — measured, disclosed, issue #42

# v2.1: we benchmarked ourselves and published the losses too
$ uv run python benchmarks/afb/run_afb.py
fault_localization  median 9.5 entries  gate ≤ 5   REJECT   # real localizer bug, issue queued
$ uv run python benchmarks/cc_hook_latency/run_cc_hook_latency.py
prompt p95 275 ms  gate ≤ 200          REJECT:prompt  # prompt-time recall ships off

from kaos import Kaos

db = Kaos("team.db")                    # one SQLite file — the whole runtime

alice = db.spawn("alice", config={"role": "researcher"})
bob   = db.spawn("bob",   config={"role": "implementer"})

db.write(alice, "/notes.md", b"# Findings\n- auth.py: 3 bugs")
db.read(bob, "/notes.md")                # FileNotFoundError — isolation is enforced

cp = db.checkpoint(alice, label="before-refactor")
db.write(alice, "/notes.md", b"# Findings\n- 5 bugs total")
db.restore(alice, cp)                    # byte-exact time travel

db.query("SELECT event_type, COUNT(*) FROM events GROUP BY 1")  # audit = SQL

from kaos.eval.harness import Probe, GateOutcome, bootstrap_diff_ci

class FewshotProbe(Probe):
    lock_path    = "ISA.lock.json"        # kill gates, written BEFORE any code
    known_sha256 = {"5aa9c10d…": "v1"}    # edited lock → harness refuses to run

    def gates(self, arms):
        md, lo, hi = bootstrap_diff_ci(arms["FULL"].labels({"hard"}),
                                       arms["B0"].labels({"hard"}))
        return [GateOutcome("G1", "beats baseline",
                            passed=md >= 0.10 and lo > 0.0, kill=True,
                            detail=f"diff={md:+.3f} lo={lo:+.3f}")]

probe = FewshotProbe()
_, verdict = probe.falsify()   # FULL := B0 must emit [KILL] — or the probe is inadmissible
result = probe.run(out_dir=".")  # binding ACCEPT / REJECT / VOID. No retune.

# From Claude Code / Cursor / any MCP client — natural language:
with kaos, review my payments module — run a security agent
and a test-writing agent in parallel

# Or the CLI:
kaos parallel -t security "find vulnerabilities in auth.py" \
              -t tests    "write unit tests for auth.py"
kaos ui                                  # Gantt of every agent, live events
kaos eval probe run --probe my.bench:MyProbe --out-dir out/   # exits ≠0 on REJECT — CI-gate your harness
kaos query "SELECT tool_name, COUNT(*) FROM tool_calls GROUP BY 1"