v2.0.2

ai-memory 2.0.2

A patch release that hardens the 2.0 line — most importantly, it fixes two startup crash-loops that could block a 1.x→2.0 upgrade, and meets OpenCode Go's Sept 6 header requirement.

Upgrade-blocking fixes (upgrade to this before migrating)

• Windows: the OKF migration no longer aborts on the .serve.lock file the same server holds under an exclusive lock (os error 33). The backup walk now skips it. (#593, thanks @Gaalbu / @rafaelkenedy)
• libgit2 crash-loop fixed: the OKF migration could fail with invalid object specified … class=Tree and never start; the wiki commit now clears its index before staging so a stale cached blob OID can't abort it. (#594)

Fixes

• OpenCode Go: requests now send x-opencode-session + User-Agent: ai-memory/<version> — required before OpenCode Go starts rejecting header-less requests on 2026-09-06. (#608, thanks @lucazz)
• ZCode: install-hooks --agent zcode --apply no longer reports a config ZCode has rejected as "already up to date"; it now reports the offending keys. (#600, thanks @costajohnt)
• Empty page titles: pages with a blank frontmatter title (but a real # H1) read back correctly and no longer trip a bogus duplicate-title lint. (#599)
• Web UI: OKF bundle-index and relative in-wiki links no longer 404; directory paths list their pages. (#603)
• as_of / entity retrieval now work on real stores (entity index is populated from tags + a startup backfill). (#592)
• Local embeddings: the model download can no longer hang startup forever (connect + overall timeout). (#602)
• Windows PowerShell wrapper no longer crashes running status outside a git repo. (#591)

Security / hardening

• Auth-bearing HTTP headers with opaque values are redacted before capture. (#598, thanks @gb)
• Untrusted frontmatter values are length-bounded before logging; handoff and workstream content is size-bounded at the store boundary (defense in depth). (#607)

Docs

• macOS quickstart now states the server must be running before bootstrap/install-*/status. (#595)

Upgrading from 2.0.x needs nothing special — docker compose pull && docker compose up -d (or your platform's equivalent). Full list in CHANGELOG.md.

Checksums (SHA256)

f415e9f278060fd62ecdfc26d140427e9c631dddc003cc050da6d2f49a3feaa1  ai-memory-hooks.tar.gz
448f6cfad616e13692598dd49709ce9dec10eed0f702818ccca4a0c54a79f8c7  ai-memory-install-hooks
14c4ef51cb45ce7095abbabee2fe72a9d394fc72ceac51e29119747317af3baa  ai-memory-linux-aarch64.tar.gz
3c39d8d9afad57a34747e6c52a13036b7411de95e4a2b1bbcd11976f4da31a23  ai-memory-linux-x86_64.tar.gz
1b7113614c76f6d38d80e39d9657806e6621a3cd20eeddd0c1927eadacc1d0c6  ai-memory-macos-aarch64.tar.gz
2823c93a6e323718a1138501b926a1e46a73aab1d60cb3a8cd3ac45b98498a2e  ai-memory-macos-x86_64.tar.gz
33812222b35ff871a27b781855089825f1ad161b099c409e7c5c14180a07aa85  ai-memory-windows-x86_64.zip
6a91c44ffa2e85d3b5a6ce26a4ccff0286b91d08d276d2bb4d47c346b036ee8b  ai-memory-wrapper.cmd
2d35c2f1fba28a1aee3ffeb58e3deaec772803f3dc6fd159de6ae0a47ba797ac  ai-memory-wrapper.ps1
4b2e5736195f0ac4cd38adf62f25b294922ebf81f5f4802a07803e1abbf9f72d  ai-memory-wrapper

Install

# Arch Linux (AUR)
yay -S ai-memory-bin      # prebuilt Linux x86_64/aarch64 binary
yay -S ai-memory          # builds from source

# Docker
docker pull akitaonrails/ai-memory:2.0.2

# macOS aarch64/x86_64 (no toolchain): download the matching ai-memory-macos-<arch>.tar.gz below,
# extract it, and follow the bundled docs/macos.md.

# Windows x86_64 (no toolchain): download ai-memory-windows-x86_64.zip below,
# extract it, and follow the bundled docs/windows.md.

# From source
cargo install --git https://github.com/akitaonrails/ai-memory --tag v2.0.2