engine
source

03 · agents

It spawns. It isolates.

The orchestrator has no filesystem tools of its own — just spawn calls. Every writer works alone, on its own branch.

[*] 6 named personas, up to 8 concurrent, sharing a 120,000-token budget.

Six specialists.

askAnswers "how does this work." Can't edit, can't run. main workspace
coderTakes a brief, edits the files. Must check its own diagnostics. isolated worktree
testerTests only, never production code. Must run something. isolated worktree
researcherWeb search and fetch. Cites its sources. main workspace
debuggerLogs, LSP, a headless browser. Finds it, doesn't fix it. main workspace
reviewerApprove, request changes, or block. Never merges. joins the writer

Nothing lands without you.

Writers finish on their own branch. You get one question back.

mergeCommits, then lands on your branch.
open a PRgh pr create. Link back in chat.
keepBranch stays. Merge it yourself.
discardGone. Empty ones vanish with no prompt.

One report, not thirty.

A child's tokens never reach the chat. compress_for_parent folds the transcript into one status report.

Worker trail · 34 messages

live
  1. thinkmaybe the timeout is in the client retry loop…
  2. toolgrep timeout auth.spec.ts session.ts
  3. resultsession.ts:88 timeout: 5_000
  4. think5s is tight under CI load. bump and retest.
  5. toolfile.write session.ts timeout 5s → 15s
  6. resultpatched +1 / −1
  7. thinkrun the flaky spec again, twice, then stop.
  8. toolpnpm test --filter=api auth.spec
  9. resultok 2 passed 0 flaky

+25 more · thinking · tool_call · tool_result

Folded into orchestrator · 3 messages

    waiting for compressor…

    Shipped

    • [*] 32 tools, ten families — including web and a browser
    • [*] A write funnel: identity, syntax gate, atomic commit, undo
    • [*] 6 subagents, isolated worktrees, up to 8 at once
    • [*] Merge / PR / keep / discard — always your call
    • [*] Context compaction, memory across sessions
    • [*] Real language servers for Python, Go, JS, TS

    Known limits

    • [*] Free to run for dev and eval. Production needs a license.
    • [*] Deep tooling covers 4 languages. 14 more are detected only.
    • [*] Browser tools need Playwright installed.

    None of the six is a ceiling, either — a new persona is one file. See extend.

    Clone it today.

    github.com/iresharma/codeloom.engine
    next04.extend