First task walkthrough

Quick Start gets the tool installed. This page covers the next step:0dai run "…" --now runs one small task locally with your installed agent CLI and writes a scored receipt — no account, no swarm fleet. Scaling that to a branch and pull request is the team/Pro flow, covered lower down.

The canonical free first task: 0dai run "add a test" --now on your own repo, then read the scored receipt it writes back to your project.

Target outcome (team/Pro: branch + PR)

Once run --now feels useful, the team/Pro swarm flow takes a tiny issue all the way to a reviewable pull request. Use a small task: add a health check endpoint, fix one failing test, or update a doc link — small enough for a junior developer to review without trusting the agent blindly.

  • A real repository, not a mocked transcript.
  • A branch with one narrow change.
  • Tests, lint, or an explicit note explaining why none apply.
  • A pull request with the command run and the verification result.

Commands

npm install -g @0dai-dev/cli
cd your-project
0dai init --local
0dai run "add a test for the auth module" --now

0dai run --now runs the task with your installed agent CLI (claude, codex, …) locally and writes a scored receipt — no account and no swarm fleet. Run 0dai doctor to check which agent CLIs are available. The branch-and-pull-request flow below is the team/Pro swarm path and also needs the gh CLI.

What to watch for

The useful part of the walkthrough is not that an agent typed code. It is the control loop around the code: the agent reads the project layer, scopes the task, writes a small patch, verifies it, and leaves a receipt.

MomentGood signStop if
0dai initai/ and native agent configs are created.The command wants secrets, production credentials, or broad repo access.
0dai doctorIt reports the project layer and agent config health.It cannot find the repo root or generated config files.
First taskThe branch touches only files needed for the issue.The agent rewrites unrelated files or expands the goal.
Pull requestThe PR body names the issue, files touched, and checks run.The PR claims a test passed without a command or log.

PR review receipt (team/Pro)

Distinct from the free run --now scored receipt above: when you scale to the team/Pro swarm flow, the pull request itself is the receipt. A good first PR body is short and specific — enough context for a reviewer to decide whether the change is narrow.

Fixes #123

Changed:
- added GET /health
- added route test

Verified:
- npm test -- health
- npm run lint

Video publish gate

The landing-page video should publish only after these are true:

  • It shows a real repository and a real pull request.
  • It includes faces and voices or a spoken walkthrough, not only a silent screencast.
  • Captions are present and accurate.
  • No metric, time, or customer claim is invented for the recording.
  • The final cut stays under 10 minutes and links back to this page.

Next up