Agent Memory CLI — Data skill for Claude Code

Shared Agent Memory

Shared project memory for coding agents such as **Claude Code** and **Gemini Antigravity**. Memory is plain Markdown in `docs/memory/`, committed to the repository. No server, database, API keys or OpenClaw required.

The core principle: **the Markdown files are the source of truth; the CLI is only a helper.** Every file can be read and edited by hand, any agent that reads `AGENTS.md` follows the same protocol, and per-agent automation (hooks) is an addition, not a requirement.

            ┌────────────────────────────────────────────┐
            │      agent-memory / shared-memory (CLI)    │
            │ install · read · save · search · handoff · │
            │            test · status · doctor          │
            └────────────────────────────────────────────┘
  ┌───────────────────────────────┐  ┌───────────────────────────────┐
  │          Claude Code          │  │      Gemini Antigravity       │
  │ CLAUDE.md + .claude/settings  │  │ AGENTS.md + .agents/hooks.json│
  │ SessionStart · Stop · SessEnd │  │ SessionStart · Stop           │
  │ /memory-handoff, /memory-save │  │ /memory-handoff, /memory-save │
  └───────────────┬───────────────┘  └───────────────┬───────────────┘
                  └────────────────┐  ┌──────────────┘
                                   ▼  ▼
            ┌────────────────────────────────────────────┐
            │      docs/memory/  (Markdown, in git)      │
            │  project · decisions · learnings · handoff │
            └────────────────────────────────────────────┘

The tool **never touches** Claude's (`~/.claude/…`) or Gemini's (`~/.gemini/…`) internal memory directories. Memory therefore stays auditable, can be reviewed in pull requests, and moves to another machine with a `git clone`.

Installation

**1. The CLI, once per machine.** Requires Node.js 18.17 or later. No other dependencies.

npm install -g github:andriest/agent-memory-cli   # once this repo is pushed to GitHub
# or