Getting started

Getting started

The shortest path from zero context to a useful ota workflow.

learnnew usersbasicstable2026-04-11

Start here

ota works best when you begin with diagnosis, not guessing.

If the repo already has ota.yaml, use ota doctor to understand readiness before writing anything.

Review the repobash
ota doctorota validateota workflowsota execution topologyota tasksota up

When you do not have a contract yet

Use detect to infer a starter contract from the repo signals you already have.

Detector-led onboarding lanebash
ota doctorota detect --dry-run .ota detect --contract .ota init --dry-run .ota init .ota up --dry-run .

The default loop

  • doctor first
  • contract second
  • write only after review
  • keep JSON output for CI and automation
Default operational loopbash
ota doctorota explainota init --dry-runota validateota up