v1.0.0 — initial public release

headlesscode 1.0.0 — initial public release

Standalone headless coding-agent harness: runs the Zoo Code agent loop (prompts, tools, modes) without a VS Code UI, driven by CLI, HTTP, and parallel worktree orchestration.

Highlights

• Headless runtime engine — vendored Apache-2.0 portable core from Zoo Code (prompts, native tool schemas, mode/rules config) with a headless OpenRouter client, tool executor, tool-call parser, and orchestration loop.
• CLI + HTTP control plane — npx tsx src/cli.ts <task> for one-shot runs, plus a dashboard server with project registry, session timeline, cost/token charts, and a synchronous tool-execute endpoint.
• Parallel worktree orchestration — split an issue batch into worker groups, run each as a harness subprocess in its own git worktree, review, rework, QA, and merge.
• GitHub automation — issue watcher (label → auto-spawn), GitHub App auth, branch push + PR creation.
• Memory subsystem — per-project facts + rolling session summaries with local semantic recall and a pluggable MemoryStore contract.
• Budget/cost guardrails — per-session cost/time/iteration caps, prompt-cache-aware cost accounting, cloud-provider abstraction (evaluation-only, no live cloud launched).
• Code intelligence — codebase_search, outline, go_to_definition, find_references, import_graph, describe_image, diff-based editing with fuzzy matching.
• Secure-by-default awareness — full disclosure of the default-allow command execution model in SECURITY.md, with an optional permissions layer.

License

Apache-2.0. Vendored Zoo Code core attributed in ATTRIBUTION.md.

Installation

Not yet on the npm registry — install from a checkout:

git clone https://github.com/Capsize-Games/headlesscode.git
cd headlesscode
npm install
export HEADLESSCODE_OPENROUTER_API_KEY=sk-or-...
node bin/headlesscode.mjs --task "Fix the bug in src/index.ts" --workspace /path/to/target/repo

See README.md for the full quick start.