kairn

Kairn v0.2 · Public beta

Help your coding agent find the right code faster.

Kairn points Codex and other coding agents to the files that matter—so they spend less time searching, avoid rereading the same code, and use fewer tokens. It runs locally and does not upload your repository to Kairn.

  1. 1. Install Kairn

    npm install -g usekairn@beta

  2. 2. Enable it in your repository

    kairn enable

See real results

Finding the right files is only the beginning.

Kairn also keeps track of what the agent has seen. It can skip unchanged code on a follow-up, then refocus when the work brings a new clue.

Illustrative session

A browser bug, across a session.

qutebrowser · a browser built with Python

Start with a real coding task.

Blocked sites should also block their subdomains. Allowlisted sites must still open.

Your request
Block example.com and its subdomains. Keep allowlisted sites open.

The agent still writes and checks the fix. Kairn helps decide which code to show it.

Step 1 of 4. Start with a real coding task. Blocked sites should also block their subdomains. Allowlisted sites must still open.

This is an illustrative session, not a replay. A separate evaluated run of this task passed with Kairn and failed without it. See the result and caveats

Less time figuring out where to make a change.

Without Kairn

  • Search broadly across the repository.
  • Open unrelated files to find a starting point.
  • Reread the same code as the session continues.

With Kairn

  • Start with a file likely to matter.
  • Keep the task focused on a narrower set of files.
  • Avoid sending unchanged code again.

Kairn scans the repository locally and suggests files as work continues. When it has nothing useful to add, it stays quiet.

Historical beta results

Measured by the work that gets done.

Official coding tasks from earlier campaigns. Savings only count when the task still passes.

Explore the results

With Kairn

20/ 25
tasks passed

Without Kairn

15/ 25
tasks passed

Passed Did not pass

Works with the coding agents you already use.

Codex is the most-tested integration. Connect Claude Code, Gemini CLI, or VS Code / Copilot through MCP, a standard for connecting agents to tools.

Set up your agent

Kairn does not upload your repository.

Your repository files, Kairn's index, and session data stay local. Optional aggregate telemetry is off by default.

Read the privacy details

Give your coding agent a better place to start.

Install Kairn Read the docs