DevMemory

Persistent developer memory for AI coding agents. One command configures memory across all your AI tools.

Quick Start

npx @agenticcoders/devmemory setup

You'll be prompted for:

1. API key — your DevMemory API key
2. Org/username — your GitHub org or username (used for memory isolation)
3. Endpoint — press Enter for the default (devmemory.agenticcoders.dev)
4. AI clients — select which tools to configure

That's it. DevMemory is now active for all your projects.

What It Does

DevMemory gives your AI coding agents persistent memory across sessions. What an agent learns in one session — debugging fixes, architecture decisions, anti-patterns — is available in every future session, across all projects.

Session 1: Agent discovers "Cognito tokens have no aud claim"
             → remember(kind="fact", confidence=0.9)

Session 2: Agent hits the same auth error
             → recall("auth token aud claim")
             → Instantly recalls the fix — no re-investigation needed

Setup configures:

| What | Where | Purpose | |------|-------|---------| | MCP server | Each client's config | Connects to DevMemory via stdio proxy | | Rules file | CLAUDE.md, Kiro rules, Codex instructions | Tells the LLM how and when to use memory | | Session hooks | Claude Code, Kiro | Auto-loads memories on session start, saves on end | | Tool auto-approve | Claude Code, Kiro, Cline | No manual approval prompts for memory tools |

Supported AI Clients

| Client | MCP | Rules | Hooks | Auto-approve | |--------|-----|-------|-------|-------------| | Claude Code | Global (~/.claude.json) | ~/.claude/CLAUDE.md | SessionStart / SessionEnd | permissions.allow | | Cursor | Global (~/.cursor/mcp.json) | Project-level only | — | — | | Windsurf | Global (~/.codeium/windsurf/mcp_config.json) | Project-level only | — | — | | Kiro | Global (~/.kiro/settings/mcp.json) | ~/.kiro/rules/devmemory.md | devmemory init-hooks | autoApprove | | VS Code (Copilot) | User settings.json | Project-level only | — | — | | Cline | VS Code globalStorage | Project-level only | — | alwaysAllow | | Codex CLI | ~/.codex/config.json | ~/.codex/instructions.md | — | — |

Commands

# Setup & management
npx @agenticcoders/devmemory setup       # One-time setup (interactive)
npx @agenticcoders/devmemory status      # Show current configuration
npx @agenticcoders/devmemory uninstall   # Remove from all clients

# Kiro project-level hooks (run in each project)
npx @agenticcoders/devmemory init-hooks  # Create .kiro/hooks/ for this project

How It Works

AI Client (Claude Code, Cursor, Kiro, ...)
    │
    │ stdio
    │
devmemory proxy (this CLI)
    │ ── auto-detects project from git remote
    │ ── injects x-devmemory-project header
    │ ── injects x-devmemory-org header
    │
    │ Streamable HTTP
    │
DevMemory Server (devmemory.agenticcoders.dev)
    │ ── 8 MCP tools: recall, remember, reinforce, contradict, ...
    │ ── trust-scored, cross-project memory
    │ ── no init() needed — headers carry identity

The proxy runs locally as an MCP stdio server. It auto-detects the project from git remote get-url origin, injects identity headers, and forwards all tool calls to the DevMemory server. No per-project configuration needed.

Memory Tools

The DevMemory server exposes 8 tools via MCP:

| Tool | When to use | |------|-------------| | recall | Before starting work, before risky actions, when hitting errors | | remember | After solving something, when user corrects you, when docs differ from reality | | reinforce | When a recalled memory proves correct (include token/call savings estimates) | | contradict | When a recalled memory is wrong or outdated | | check | Before deployments, migrations, config changes — checks for known anti-patterns | | forget | When a memory is completely irrelevant | | status | To see what memory is available and verify identity | | init | Not needed — the proxy handles project context automatically |

Reconfiguring

Run setup again — it preserves your existing values as defaults:

npx @agenticcoders/devmemory setup
# Existing config found. Press Enter to keep current values.
# Reconfigure? (y/N): y
# API key (dm-3962****):              ← Enter to keep
# GitHub org or username (myorg):     ← Enter to keep

Prerequisites

• Node.js 18+
• uv (brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh)
• A DevMemory API key

Troubleshooting

| Issue | Fix | |-------|-----| | uvx not found | Install uv: brew install uv | | Permission denied writing config | Check file ownership: sudo chown -R $(whoami) ~/.devmemory | | MCP tools show "not trusted" in Kiro | This is a UI label — tools still auto-approve when called | | Wrong project in status | Check git remote get-url origin in your project directory | | Setup fails for one client | Other clients still configure — errors are shown at the end |

License

MIT