Skip to content

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.md
index 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 alternate
root.
diff --git a/README.md b/README.md
index 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 a
terminal) - FTS5 over the wiki. Pages are LLM-consolidated, so
the 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