Kairo Runtime

Kairo finds the AI agents you already use — Cursor, Codex, Claude, OpenCode — and keeps their configuration under control. One place to see what's set up, repair what drifted, and roll back when something breaks.

It does not install AI apps and it does not dump templates. It manages marked sections inside the configs you already have, and it never writes without asking.

Start

npx @kal-elsam/kairo-runtime

That's it. The first run walks you through setup; after that it opens the cockpit:

KAIRO

Needs attention · 4/4 agents · drift pending
Kairo coordinates installed AI agents for this project.

→ Repair 3 changes
  You will see the exact plan before anything is written.

  Configure
  Agents, Obsidian vault, integrations.

↑↓ move · Enter open · Tab nav · Space details · R refresh · Esc back · ? help

Day-to-day commands

| Command | What it does | |---|---| | kairo | Open the cockpit | | kairo status | See how your setup is doing | | kairo sync | Repair what drifted | | kairo update | Update Kairo itself from npm | | kairo doctor | Deeper health checks |

Run kairo help --all for everything else, or read the CLI reference.

What it guarantees

• Your files stay yours. Kairo writes only between <!-- harness:managed:start --> / <!-- harness:managed:end --> markers. Everything outside them is preserved untouched.
• Every write is reversible. Configs are snapshotted first; kairo rollback restores a prior snapshot.
• Nothing happens without consent. Previews are the default; applying requires an explicit --yes or a confirmation in the UI.
• No permanent daemons. Background monitoring is opt-in via kairo monitor enable.

Install

Requires Node.js 20.12 or newer.

# Run without installing
npx @kal-elsam/kairo-runtime

# Install globally
npm i -g @kal-elsam/kairo-runtime && kairo

# Later: update the CLI itself
kairo update
kairo update --yes

# Preview the setup plan, write nothing
npx @kal-elsam/kairo-runtime --dry-run

There is also a bootstrap script that checks Node, installs the CLI, and previews the plan without writing anything — see installation options.

Docs

| Guide | Contents | |---|---| | CLI reference | Every command, flag, and --json output | | Agents & adapters | Supported agents, config roots, Pi runtime, reviews | | Components | Orchestrator, Engram memory, SDD Core skills | | Intelligence | Local-first routing, budgets, cloud consent | | Integrations | Gentle AI, Engram, Graphify, Obsidian | | Workspace scope | Opt-in per-repo scaffolding and manifests | | Contributing | Release process, tags, branch chains |

Links

• npm: https://www.npmjs.com/package/@kal-elsam/kairo-runtime
• Repo: https://github.com/Kal-elSam/harness
• Changelog: CHANGELOG.md
• License: MIT