Skip to content
niki
All examples

Task: add a /health endpoint

The canonical first task — one sentence, four agents, a verified branch.

--- title: "Task: add a /health endpoint" description: "The canonical first task — one sentence, four agents, a verified branch." pubDate: "2026-09-08" difficulty: "beginner" stack: ["any"] ---

The one-sentence task used across Niki's demo and smoke tests:

niki run "Add a GET /health endpoint returning { status: 'ok', uptime }" --project ./my-app

What happens per stage:

  • Planner — reads the repo, emits a TaskSpec: which file to touch, the approach.
  • Coder — emits a unified diff against a sandboxed copy of the workspace.
  • Tester — generates and runs tests for the endpoint, each with oracle provenance.
  • Reviewer — scores correctness, quality and coverage; bounces back if below bar.

Output: a niki/<id> branch, changes.patch, report.md and per-agent JSON artifacts. Nothing touched your working tree, and nothing lands on main until you merge.

niki