Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
docs: add permanent-note (memory_write_page) use case + changelog for upcoming release
AkitaOnRailsbc62ae91fb36
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 36d212b6..f865d641 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,7 +6,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).## [Unreleased]+### Added+- `anthropic-oauth` LLM provider: use a Claude Pro/Max subscription via+ `claude setup-token` instead of an API key. In-Rust, reuses the existing+ Anthropic Messages client (incl. structured output). **Unofficial and+ against Anthropic's usage policies — use at your own risk** (docs warn+ prominently).+- Opt-in `AI_MEMORY_CONSOLIDATE_ON_SESSION_END`: when set and an LLM provider+ is configured, SessionEnd additionally runs LLM consolidation on top of the+ always-written rule-based summary page (non-fatal on failure) ([#40]).++### Changed+- Docs recommend a small/fast model (Haiku/mini class) for the OAuth /+ subscription LLM backends — consolidation/lint/explore is summarisation, not+ hard reasoning, and small models are far easier on subscription rate limits.+- Aligned every prompt surface + doc with actual SessionEnd behavior: it always+ writes a rule-based summary page + handoff; LLM consolidation runs on+ PreCompact, on demand via `memory_consolidate`, and at session end only+ behind the new opt-in flag ([#40]).+### Fixed+- Windows own-write detection: `inode_of` now returns the real NTFS file index+ (was always `0`, which collapsed the watcher's own-write set) ([#37]).+- `ai-memory upgrade` no longer fails with `invalid value 'lib' for --agent` —+ the hook-refresh loop skips the shared `lib/` helper dir ([#38]).- Native packaging CI now supports non-root runners whose `systemd-tmpfiles`lacks `--dry-run`, while still operating only inside a temporary alternateroot.diff --git a/README.md b/README.mdindex a9079f96..b07e1d54 100644--- a/README.md+++ b/README.md@@ -96,6 +96,17 @@ priors are at the [bottom](#influences-and-prior-art).`memory_query X` from the agent (or `ai-memory search X` from aterminal) - FTS5 over the wiki. Pages are LLM-consolidated, sothe hit is a coherent decision page, not a raw chat log.+- **"Remember this permanently."** When something is worth keeping+ beyond auto-captured session logs - a decision, a convention, a+ gotcha - tell the agent "save a permanent note that we standardised+ on Postgres for X" or "annotate this as a project rule" and it calls+ `memory_write_page` to write a durable, git-versioned wiki page. From+ a terminal it's `ai-memory write-page --path decisions/0007-db.md+ --title "Standardised on Postgres" --body "..." --pinned` (`--pinned`+ exempts it from the decay sweep). Unlike a handoff (single-use) or an+ auto-synthesised session page (rewritten on consolidation), a+ write-page note is yours: it shows up in `memory_query`, renders in+ `/web`, and stays until you change it.- **"This new project has months of history before ai-memory."**`cd /path/to/my-project && ai-memory bootstrap` collects`git log`, README, `docs/`, module headers, project rules and