-
Notifications
You must be signed in to change notification settings - Fork 0
Home
The memory that follows your coding agent — so you get the assistant you actually wanted.
Works with Claude Code + Antigravity — see compatibility
AgentM gives your coding agent a permanent memory. It writes what it learns — about you, and about each project — as plain Markdown notes in a folder you own: no hidden database, nothing you can't read or edit yourself. Memory splits into two tenants — personal notes on how you like to work, and a per-project record of decisions and open threads — so a fresh session can pick up exactly where the last one left off. It brings the right notes back at the right moment, and looks after the collection over time so it gets better instead of messier.
Said differently, AgentM is the memory and self-improvement layer — it dreams and learns between sessions. A phase-gated development workflow (setup · plan · work · review · release · bugfix) can run on top of it, provided by a companion toolkit rather than by AgentM itself. Its customization system extends AgentM's own abilities through plugins that enable long-running, nuanced development workflows, automated project management, and more. Its opinion system is designed to layer in personas focused on a specific kind of work — activation is the next build slice.
AgentM works best paired with crickets — the toolkit of plugins (capabilities, skills, hooks, and sub-agents) that make it even more useful.
AgentM installs alongside your coding agent — Claude Code or Antigravity — so you can be up and running in a few minutes. See requirements.
Install AgentM and crickets with the recommended configuration and a Google Drive vault:
# Point the vault at a Google Drive folder named "Agent" (the recommended default)
export MEMORY_VAULT_PATH="<your-google-drive>/Agent"
# Install AgentM for every project on this machine (user scope) + verification hooks
bash ~/agentm/install.sh --hooks --scope user
# Add the crickets plugins (Claude Code + Antigravity)
curl -fsSL https://raw.githubusercontent.com/alexherrero/crickets/main/bootstrap.sh | bashStep-by-step, with the vault and hooks explained: Install machine-wide (recommended). More on the available configurations here.
The wiki covers everything there is to know about AgentM. A few links to get you started.
- Why we built it — the problem, the solution and the reason.
- Architecture — how it's made.
- Reference — fields, flags, schemas and more.
- What we built, when — the combined build timeline for AgentM and crickets, plus the roadmap-era-to-release-tag decoder.
The memory vault itself is browsable by kind — every note groups into a generated Map of Content (MOC) alongside its siblings of the same kind (fix, pattern, decision, and dozens more), so you can scan every entry of a kind without a search. See MOC generator for how the pages are built, and Kind-taxonomy registry for the kinds it recognizes.
Note
Latest release: v9.5.0. A recalled memory's score breakdown used to exist for one prompt turn, then vanish — memory-recall trace <slug> now explains why any past recall surfaced what it did, kept in the existing per-recall ledger.
🔧 How-to
- Install machine-wide (recommended)
- Your first install
- Your first Agent View dispatch
- Install into a project
- Configure a new project
- Update an installed harness
- Use auto-context in phases
- Use per-project install
- Audit the vault
- Find missing note links
- Use AgentMemory in any agent
- Tune auto-orchestration
- Run without a vault
- Choose a storage backend
- Back the vault with Google Drive
- Set up Obsidian on the vault
- Stand up the memory MCP server
- Persist a morning report
- Enable on-device notifications
- Enable email digest delivery
- Ingest an article
- Capture from your phone
- Archive a finished project
- Tune the archive
- Installer CLI
- Supported configurations
- Detection rules
- Project config
- GitHub Projects sync
- Migration tool
- CI gates
- PII Guardrail
- Repo layout
- Vault lint checks
- Note relatedness signals
- AgentMemory context payload
- Process seam
- Storage seam
- Orchestration bridge
- Vault write protocol
- Queue status lite
- Auto-orchestration config
- Capability resolver
- Design governance
- Persona tier schema
- Compatibility
- Completed features
- Known issues
- Memory MCP tools
🏛️ Architecture
- AgentMemory
- Device-Wide Substrate
- Phases
- Orchestration and Auto-Detection
- Host adapters
- Toolkit interface ↔ crickets