@kata-sh/cli

Kata Skills runtime and backend contract bridge.

This package provides the durable operation layer for Kata project workflows. Skills and harnesses call into it for project, milestone, slice, task, artifact, progress, and completion operations instead of writing directly to backend systems.

The 0.17.x line is the stable release for the Kata Skills runtime and backend contract bridge. Version 0.17.0 adds in-flight project artifact updates and emphasizes demo-able vertical slice planning.

Install with:

npm install -g @kata-sh/cli

For monorepo development:

pnpm --dir apps/cli run build
pnpm --dir apps/cli run test

Commands:

• kata setup --pi
• kata setup --backend github --repo owner/name --project-number 12
• kata setup --backend linear --linear-workspace <workspace> --linear-team <team> --linear-project <project>
• kata doctor
• kata call <operation> --input <request.json>
• kata json <request.json>

Runtime shape:

• apps/cli/skills-src is the source of truth for generated Kata Agent Skills.
• apps/cli/skills is the generated skill bundle packaged with @kata-sh/cli.
• kata setup installs packaged skills into Pi, project-local/global agent skills, Claude skills, or Cursor skills depending on the selected target flags.
• Backend adapters include GitHub Projects v2 and Linear under src/backends.
• Linear auth resolves from LINEAR_API_KEY, LINEAR_TOKEN, or configured linear.authEnv.
• Standalone issue workflows use kata-plan-issue and kata-execute-issue with issue.listOpen, issue.create, issue.get, and issue.updateStatus operations.
• In-flight project updates use kata-update-project to refresh project and active milestone artifacts without creating new execution scope.
• Roadmap planning favors demo-able vertical slices with independent test surfaces, slice maps, dependency graphs, and implementation waves.

Release channel:

• Stable releases publish to npm as @kata-sh/cli@latest.
• Prereleases publish under their prerelease dist-tag, such as alpha.