Dev MCP Suite 🚀

Give your AI Coding Assistant Permanent Brain Power & Zero Memory Loss.

Published on npm as codex-dev-mcp-suite.

😩 Sound Familiar?

"You spent 45 minutes explaining your database schema and architecture to your AI agent. Then... 'Context window compacted' or session restarted. Boom. Your AI forgot everything and started hallucinating variable names."

Stop re-pasting context over and over.

Dev MCP Suite is a suite of four local, zero-telemetry MCP (Model Context Protocol) servers built for solo developers and vibe coders. It equips your favorite AI agent (Codex CLI, Hermes Agent, Google Antigravity, Claude Code, Cursor, Windsurf) with permanent memory, anti-compaction handoffs, git-safe checkpoints, and offline vector search.

⚡ Before & After Dev MCP Suite

⚡ 10-Second Quickstart

Automatically configure all installed AI tools (Codex CLI, Claude Code, Cursor, Windsurf, Hermes, Antigravity) with 1 command:

npx -y codex-dev-mcp-suite init

Or test a single server right now without installing:

npx -y -p codex-dev-mcp-suite project-memory-mcp --help

🛠️ The 4 Superpowers (MCP Servers)

🧠 Intelligent Local-First Semantic Search

memory_recall automatically selects the best available search engine on your machine:

1. Local Offline Vector Search (v1.8.0) — Set MCP_LOCAL_EMBED=true to use the built-in, zero-dependency 384-dimensional term-frequency hashing vector engine. Sub-millisecond execution, zero network requests, 100% private.

2. Remote Embeddings (Optional) — Connect any OpenAI-compatible /v1/embeddings endpoint (OpenAI, Cloudflare Workers AI, Ollama, LM Studio, 9router, OpenRouter).

3. LLM Reranking (Optional) — Hybrid keyword pre-filter followed by LLM reranking for high-precision recall.

4. Keyword Fallback — Always-available offline fallback if no network or API keys exist.

🔌 Plug & Play with Any MCP Client

1. Codex CLI (~/.codex/config.toml)

[mcp_servers.project-memory]
command = "npx"
args = ["-y", "-p", "codex-dev-mcp-suite", "project-memory-mcp"]

[mcp_servers.devjournal]
command = "npx"
args = ["-y", "-p", "codex-dev-mcp-suite", "devjournal-mcp"]

[mcp_servers.checkpoint]
command = "npx"
args = ["-y", "-p", "codex-dev-mcp-suite", "checkpoint-mcp"]

[mcp_servers.context-pack]
command = "npx"
args = ["-y", "-p", "codex-dev-mcp-suite", "context-pack-mcp"]

2. Hermes Agent (~/.hermes/config.yaml)

mcp_servers:
  project-memory:
    command: project-memory-mcp
    env:
      MCP_LOCAL_EMBED: "true"
  devjournal:
    command: devjournal-mcp
  checkpoint:
    command: checkpoint-mcp
  context-pack:
    command: context-pack-mcp

3. Google Antigravity CLI / Cursor / Claude Code (mcp.json)

{
  "mcpServers": {
    "project-memory": { "command": "project-memory-mcp", "env": { "MCP_LOCAL_EMBED": "true" } },
    "devjournal": { "command": "devjournal-mcp" },
    "checkpoint": { "command": "checkpoint-mcp" },
    "context-pack": { "command": "context-pack-mcp" }
  }
}

👉 See detailed client setup guides in docs/clients/.

🚀 Daily Solo Developer Workflow

• Session Start: Run pack_overview + journal_resume + memory_recall "<topic>" to get oriented in seconds.

• Before Risky Changes: Run checkpoint_create to create a safe recovery point.

• While Coding: Run memory_save to store architectural decisions, and pack_audit before committing.

• Session End / Compaction: Run journal_handoff so your next session picks up right where you left off.

📊 Utility CLIs Included

Install globally with npm i -g codex-dev-mcp-suite to access built-in maintenance tools:

• stats — View total notes, journal activity, and storage stats across all projects (stats --json).

• prune — Safely clean up temporary project scratch files (prune --yes).

• provider-smoke — Probe configured LLM providers (chat & embedding endpoints) for health and latency.

🔒 Privacy & Local-First Philosophy

• Zero Cloud Backend: Everything is saved locally as plain Markdown & JSON files on your hard drive (~/.ai-shared-memory or project directory).

• Zero Telemetry: No tracking, no user accounts, no phoning home.

• Network Isolation Ready: Set MCP_DETERMINISTIC_FALLBACK=true for 100% air-gapped, offline operations.

• See detailed privacy and data flow documentation.

☕ Support / Donasi

Jika codex-dev-mcp-suite membantu alur kerja pengkodean Anda dan menghemat waktu Anda, dukung pengembangan proyek open-source ini melalui Saweria (QRIS, GoPay, DANA, OVO, ShopeePay):

📄 License

MIT © Verry Simatupang — see LICENSE.