agent-memory-antigravity

Antigravity CLI plugin that provides GitHub-backed persistent memory across sessions and machines.

Memories written in any Antigravity CLI session are automatically committed and pushed to a private GitHub repo (agent-memory). Every new session pulls the latest state before starting.

---

How it works

• SessionStart hook: pulls the latest memory state from GitHub (remote always wins)
• AfterTool hook: commits and pushes any .md file changes in the memory repo after memory writes
• Symlink: ~/.gemini/antigravity-cli/AGENTS.md → ~/.agents/agent-memory/AGENTS.md (in the local git clone)

Antigravity's memory system reads from ~/.gemini/antigravity-cli/AGENTS.md as usual — the symlink and hooks make it durable and portable.

---

Installation

1. Install the plugin

agy plugin install https://github.com/mlarkin00/agent-memory-antigravity

2. Bootstrap

Run the bootstrap agent in an Antigravity CLI session to clone the memory repo and wire up symlinks:

/bootstrap-memory

Or invoke it as a subagent: agy agents run bootstrap-memory

This is idempotent — safe to run again if anything breaks.

---

Plugin structure

agent-memory-antigravity/
├── plugin.json                  Plugin manifest
├── AGENTS.md                    Project context
├── agents/
│   ├── bootstrap-memory.md       Provisions the memory system on a new machine
│   ├── memory-puller.md          Manual pull from GitHub
│   └── memory-pusher.md          Manual push to GitHub
├── hooks/
│   ├── hooks.json                SessionStart (pull + verify) and AfterTool (push) hooks
├── skills/                       Agent skills (workspace-specific)
│   ├── add-memory/               Saves a memory immediately without confirmation
│   ├── verify-memory/            Runs health check and offers bootstrap on failure
│   │   ├── scripts/              Helper scripts for syncing and verification
│   │   │   ├── install-symlinks.sh
│   │   │   ├── memory-pull.sh
│   │   │   ├── memory-push.sh
│   │   │   ├── memory_push_trigger.py
│   │   │   └── verify-memory.sh
│   └── uninstall-memory/         Clean removal of all plugin artifacts
├── references/                   Technical deep-dives
│   └── architecture.md           Architecture overview and Mermaid diagram
└── evals/                        Evaluation test cases for skills

---

Memory storage

The memory repo (agent-memory) is cloned to ~/.agents/agent-memory/. Memory files live at the repo root:

~/.agents/agent-memory/
├── MEMORY.md              Claude Code index (shared storage)
├── AGENTS.md              Antigravity global memory file
└── <type>_<slug>.md       Typed memory files

The symlink ~/.gemini/antigravity-cli/AGENTS.md → ~/.agents/agent-memory/AGENTS.md makes this file visible to Antigravity's memory system.

---

Troubleshooting

Run the health check:

bash ~/.gemini/antigravity-cli/scripts/verify-memory.sh

No output means the system is healthy. Warning lines prompt you to run the bootstrap agent.

---

Uninstalling

Use the uninstall-memory skill in an Antigravity session, or manually:

agy plugin uninstall agent-memory