// DOCUMENTATION

Reproduce locally

Commands to run Koko benchmarks on your machine.

Benchmarks

All benchmarks run locally from the Koko repo. Results are machine-specific — compare trends, not absolute numbers across hardware.

Prerequisites

zig build
npx playwright install chromium   # first time only
npm run build:sdk                 # auto-run before bench scripts

Microbench (local fixtures)

npm run bench:compare:publish

Runs comparison and writes report to docs/benchmarks/latest.md. Raw JSON: code-check/tmp/benchmarks/run.json.

Wikipedia crawl

npm run bench:crawl:wikipedia:publish

100 live Wikipedia URLs at concurrency 8. Report: docs/benchmarks/crawl-wikipedia-latest.md.

Density sweep

npm run bench:density:publish

Concurrency sweep for sessions-per-GB curves.

Google agent compare

npm run bench:google:agent:publish

Agent-style Google search workflows (when configured).

Full suite

npm run bench:suite

Fixtures

Local static pages in koko-test/:

  • minimal.html — bare page
  • dom-heavy.html — large DOM for query benchmarks
  • js-compute.html — JSON/hash loops
  • mixed.html — combined workload

Historical reports

Dated snapshots in docs/benchmarks/ — e.g. 2026-06-29.md.