Skip to content

v4.12.0 — Cross-surface Agent M vault access (V4 #22)

Choose a tag to compare

View all tags
@alexherrero alexherrero released this 01 Jun 15:58
· 222 commits to main since this release
v4.12.0
2e89d26

MINOR. Until now your AgentMemory vault was only readable natively by Claude Code (via its SessionStart hooks). This release makes the vault readable from every agent surface you use — Claude.ai, Claude Desktop, and Antigravity — so each one already knows your conventions, projects, and decisions without you re-explaining them every session. The mechanism is configure-don't-build: one canonical, paste-anywhere context payload plus thin per-surface wiring; no new MCP server, API, or daemon. Read-only v1 for the chat surfaces; the filesystem working agents you run (Claude Code, Antigravity) may write. Single-repo release; crickets untouched. Every surface is operator-dogfood-validated — Antigravity confirmed on both the Antigravity CLI and the Antigravity IDE.

Added

  • Canonical context payload (templates/agentmemory-context.md) — the one paste-anywhere doc that teaches any surface how to use the vault: per-surface path resolution, the folder map, read-priority order, the entry-reading conventions, and the surface-scoped read/write posture. A self-describing copy lives at <vault>/_meta/how-to-use-agentmemory.md.
  • Claude.ai reads the vault via the Google Drive connector (whole-Drive search; the payload scopes it to AgentMemory/).
  • Claude Desktop reads the vault via a local filesystem MCP server pointed at the vault (Claude-Code-grade navigation, no Drive dependency).
  • Antigravity — per-project rule (.agents/rules/agentmemory-context.md, trigger: always_on) loads vault context every session — no manual paste.
  • Antigravity — global rule (user-scope). install.sh --scope user now idempotently merges the payload into ~/.gemini/GEMINI.md (Antigravity 2.0's global rules file) as a marker-delimited managed section, so Antigravity picks up the vault in every workspace with no per-project install — parity with how --scope user installs the Claude Code adapter to ~/.claude/. New scripts/merge-managed-section.py does the idempotent merge, preserving your own GEMINI.md content.

Changed

  • Antigravity adapter migrated .agent/ → .agents/ — the Antigravity 2.0 workspace default; --update wipes any legacy .agent/ tree.
  • doctor is now host-aware — detects the host from disk (.claude/ · .agents/ · .gemini/), checks that host's paths, and skips hook checks on the hookless hosts. The Antigravity adapter reuses the shared .agents/skills/ delivery rather than duplicating doctor/migrate-to-diataxis.
  • Read/write posture is surface-scoped — chat surfaces (Claude.ai, Claude Desktop) read-only; the filesystem working agents you run (Claude Code, Antigravity) may write.

Deferred (not in v1)

  • Gemini, ChatGPT, Codex — chat-only bots with no live file/search access to the vault yet.
  • Antigravity dynamic session-start recall hook + ADR→living-design overhaul — folded into a future crickets roadmap item.
  • Connector-based write-back for chat surfaces — a distinct v2 problem.

Per ROADMAP-V4 item #22. Carries forward the v4.11.1 conflict-merger hotfix.

Assets 2
Loading