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:
- Local Offline Vector Search (
v1.8.0) — SetMCP_LOCAL_EMBED=trueto use the built-in, zero-dependency 384-dimensional term-frequency hashing vector engine. Sub-millisecond execution, zero network requests, 100% private. - Remote Embeddings (Optional) — Connect any OpenAI-compatible
/v1/embeddingsendpoint (OpenAI, Cloudflare Workers AI, Ollama, LM Studio, 9router, OpenRouter). - LLM Reranking (Optional) — Hybrid keyword pre-filter followed by LLM reranking for high-precision recall.
- 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_createto create a safe recovery point. - While Coding: Run
memory_saveto store architectural decisions, andpack_auditbefore committing. - Session End / Compaction: Run
journal_handoffso 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-memoryor project directory). - Zero Telemetry: No tracking, no user accounts, no phoning home.
- Network Isolation Ready: Set
MCP_DETERMINISTIC_FALLBACK=truefor 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.
