Skip to content

Releases: vedtechsolutions/waykeep

v5.5.1 — fresh-install fix for npm's blocked install scripts

Choose a tag to compare

@vedtechsolutions vedtechsolutions released this 31 Aug 04:41

Fixed

  • Fixed the fresh-install dead end under npm ≥ 11.5, which blocks dependency install scripts by default and leaves better-sqlite3 without its native binding (the CLI then fails at first database open):
    • waykeep doctor now recognizes the missing-addon state and prints the working one-shot fix:
      npm install -g waykeep --allow-scripts=better-sqlite3,onnxruntime-node,sharp,protobufjs
    • README and docs/INSTALL.md document the fix directly under the install command — note that npm's own suggested fix command omits the package name and errors.

No schema, hook, or behavior changes — a safe drop-in patch over 5.5.0.

Full Changelog: v5.5.0...v5.5.1

v5.5.0 — Cairn is now Waykeep

Choose a tag to compare

@vedtechsolutions vedtechsolutions released this 29 Aug 14:48

Cairn is now Waykeep. Same local-first memory for AI coding agents, new name — chosen so the project has a brand it can actually own.

What changes for you

npm uninstall -g cairn-memory   # first — npm won't hand the `cairn` bin between package names
npm install -g waykeep
waykeep init                    # re-points hook wiring at the new install
  • The CLI is waykeep (the cairn bin still works as an alias).
  • Your data is untouched — everything stays in ~/.cairn, and MCP tool names keep their cairn_ prefix, so hooks, rules files, and muscle memory keep working.
  • Codex asks to trust its hook entries once after switching — that's the install path moving, not new behavior.
  • Marketplace installs: /plugin marketplace add vedtechsolutions/waykeep then /plugin install waykeep@waykeep (Codex: codex plugin add waykeep@waykeep). Old repo URLs redirect.
  • The old cairn-memory package is deprecated but keeps working until you switch.

New in 5.5.0

  • waykeep migrate-project <old-project-id> — renaming or transferring a git repository changes the remote-derived project id and silently orphans that project's memories. This command carries memories, plans, sessions, and telemetry to the current id (--dry-run to preview), and fails closed if the old project is marked private while the new id isn't listed in your scope config.
  • The system-voice neutralizer now strips forged [waykeep …] prefixes from stored memory text alongside [cairn …] ones.

Full changelog: CHANGELOG.md

v5.4.0 — Phase 1 free launch

Choose a tag to compare

@vedtechsolutions vedtechsolutions released this 29 Aug 13:25

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