v1.2.0
DevEx polish — CLI UX + README clarity. No new architecture
subsystems. No schema changes. No new MCP tools. Pure surface polish
across the developer-facing edges that were rough on first contact.
Changed
-
Top-level
kairo --helpgains a 3-line Quick start callout
above the command list so first-time users see action items
(cd → init → doctor → status) instead of a flat command catalogue.
The footer hint now points tokairo doctorwhen something looks
off, not justkairo help <command>. -
kairo initnow detects the MCP host onPATH(currently
recognises Claude Code; structured to grow) and prints a concrete
3-step Next steps block tailored to what was found:Initialised .mcp.json: written .gitignore: appended mcp host: claude Next steps 1. Open Claude Code in this project: claude 2. Inside the session, run: /mcp → you should see kairo · connected · 41 tools 3. If anything looks off, run: kairo doctorThe
--jsonoutput gains adetectedHostfield. Existing
mcpJson/gitignore/projectRootfields are unchanged. -
kairo doctornow correctly handles the case where it's run
from inside thekairo-mcpdev repo itself (wheredist/index.js
lives at the repo root, not undernode_modules/kairo-mcp/). The
kairo-mcp installedandversion matchchecks fall back to the
self-install path whennode_modules/kairo-mcp/is absent but the
currentpackage.jsonsaysname: "kairo-mcp". -
README.mdQuick start and Real workflow sections updated to
the v1.2.0 output: realistickairo initblock with detected host- next-steps; install line no longer pins to a stale v1.1.0 tag.
Notes
- 193/193 tests still pass. CI matrix (6 cells + install-smoke) all
green on v1.1.3 baseline; v1.2.0 changes don't touch any tested
invariant. - Stability registry unchanged. No new MCP tools. No new persisted
artefacts. The CLI surface remains experimental per ADR-0016. - Success condition for this slice (per the brief): "a new
developer should understand Kairo and run it on a repo in under
5 minutes." Theinit → doctor → statushappy path now takes
3 commands and reads honestly at every step.