Skip to content

v5.4.0 — Phase 1 free launch

Choose a tag to compare

View all tags
@vedtechsolutions vedtechsolutions released this 29 Aug 13:25
· 71 commits to main since this release
v5.4.0
b62d05f

Cairn's Phase 1 free launch: everything a single developer needs to give their AI coding agents durable, local-first memory — now installable in one command from plugin marketplaces for both Claude Code and Codex CLI.

Highlights

Plugin marketplaces — install in one command

This repository now serves as a plugin marketplace for both agents:

  • Claude Code: /plugin marketplace add vedtechsolutions/cairn-memory then /plugin install cairn@cairn
  • Codex CLI: codex plugin marketplace add vedtechsolutions/cairn-memory then codex plugin add cairn@cairn

The plugins are thin — the cairn-memory npm package remains the one runtime. Full guide: docs/INSTALL.md.

Migration importers

cairn import --from codex-memories|claude-mem|memory-md migrates your existing memories — one-way, idempotent, through the standard scrubbing/dedup pipeline, with a dry-run preview and a reported exclusion list.

Scope controls

Mark a project private in ~/.cairn/config.json and its memories never surface in other projects — on any surface: briefings, injections, subagent context, recall, and graph enrichment. Reads and mutations of private content are session-bound to the owning project.

Honest tokens-saved report

cairn report shows what Cairn's memory actually saves: gross (client-reported compaction savings plus a clearly-labeled estimated proxy), the injection cost per surface, and the net. Durable per-session rollups survive telemetry pruning; two zero-write opt-outs if you want none of it recorded.

cairn-contract on npm (MIT)

The integration contract — client identity, normalized hook events, route classification, memory-path grammar, portable round-trip format, and client-adapter interfaces — is now a standalone, zero-dependency MIT-licensed package, so adapters and integrations can build against Cairn without restriction. The runtime stays Elastic License 2.0.

Quality-of-life

  • cairn init --statusline-only for marketplace-plugin users
  • cairn init --migrate-routes to modernize deprecated hook routes explicitly
  • cairn doctor detects a stale daemon left over from a previous install
  • cairn locate, --version, minimum-runtime checks
  • Exact-content dedup by construction (indexed lookup, independent of full-text search)

Install

npm install -g cairn-memory
cairn init

Full changelog: CHANGELOG.md

Assets 2
Loading