Install And Update

Install Kairn once, enable it per repository, inspect changes, and update the gated beta.

Published beta

The v0.2 beta is published on npm. Registry-verified version: 0.2.0-beta.2.

Beta.2 keeps generic MCP setup outside tracked instruction files, completes deep indexing from the npm-installed command, and reuses a healthy full index when enable is run again.

The beta dist-tag is intentionally separate from latest, which remains on the previous stable package.

Install once

Install Kairn through npm and verify the version:

npm install -g usekairn@beta
kairn --version

Continue only when the version is 0.2.0-beta.2 or a newer announced v0.2 beta.

The npm package is usekairn because kairn is already taken on npm. It installs the kairn command.

Enable a repository after verification

Run one setup command inside the repository you want Kairn to assist:

cd /path/to/repo
kairn enable

Kairn detects supported local agents, previews the Kairn-owned configuration changes, asks for one confirmation, builds the initial repository inventory, and runs setup checks. It does not modify repository source.

Useful variants:

kairn enable --dry-run
kairn enable --yes
kairn enable --agents codex,claude-code,gemini-cli
kairn doctor
kairn doctor --fix

Re-running kairn enable is idempotent. Existing unrelated agent configuration is preserved.

Disable Kairn

kairn disable
kairn disable --delete-state

The first command removes only Kairn-owned integration entries. The second also removes the repository's local Kairn state after explicit confirmation.

Update

npm install -g usekairn@beta
kairn doctor --fix

If kairn is not found after installation, check the npm global bin directory and your shell PATH.

The supported Node range is >=20.19 <26. If native Windows setup is unstable, WSL is a supported fallback.

The published v0.2 beta package is licensed under Apache-2.0. The GitHub source repository remains private today; its public source release and the stable v0.3 distribution are planned.