codex-dev-mcp-suite
Four local, file-based MCP servers for solo devs/vibecoders: persistent memory, session handoff/resume, file checkpoints, token-efficient project briefings. Works with any MCP client.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/verrysimatupang99--codex-dev-mcp-suite)HTML
<a href="/listings/verrysimatupang99--codex-dev-mcp-suite"><img src="/api/listings/verrysimatupang99--codex-dev-mcp-suite/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 166 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Dev MCP Suite 🚀
- > **Give your AI Coding Assistant Permanent Brain Power & Zero Memory Loss.**
- [](https://github.com/verrysimatupang99/codex-dev-mcp-suite/actions/workflows/ci.yml)
- [](https://www.npmjs.com/package/codex-dev-mcp-suite)
- [](https://www.npmjs.com/package/codex-dev-mcp-suite)
- [](./LICENSE)
- [](https://nodejs.org)
- [](https://saweria.co/sijuling)
- 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
- | Without Dev MCP Suite 🥱 | With Dev MCP Suite ⚡ |
- |---|---|
- | Re-explaining project setup every time session resets | One-command `journal_resume` recovers context instantly |
- | AI forgets architectural decisions and preferences | Obsidian-compatible Markdown vault retains knowledge permanently |
- | Wasted git commits just to save temporary experiments | Git-independent `checkpoint_create` & instant rollback |
- | Accidental secret/API key leaks committed to GitHub | Built-in `pack_audit` flags missing `.gitignore` & leaked keys |
- | Locked into a proprietary hosted backend | 100% Local-first, zero cloud lock-in, zero telemetry |
- ---
- ### ⚡ 10-Second Quickstart
- Automatically configure all installed AI tools (Codex CLI, Claude Code, Cursor, Windsurf, Hermes, Antigravity) with 1 command:
- ```bash
- npx -y codex-dev-mcp-suite init
- ```
- Or test a single server right now without installing:
- ```bash
- npx -y -p codex-dev-mcp-suite project-memory-mcp --help
- ```
- ---
- ### 🛠️ The 4 Superpowers (MCP Servers)
- | Server | Superpower | Key Tools |
- |---|---|---|
- | 🧠 **`project-memory`** | **Obsidian-Grade Knowledge Vault**: Persistent Markdown notes, wiki-links (`[[note]]`), MOC generation, zero-dependency local 384-d vector search (`MCP_LOCAL_EMBED=true`), multi-agent swarm stream, and autonomous background git observer (`memory_auto_index`). | `memory_save`, `memory_recall`, `memory_list`, `memory_get`, `memory_link`, `memory_moc`, `memory_graph`, `memory_dedup`, `memory_broadcast`, `memory_swarm_timeline`, `memory_auto_index` |
- | 📜 **`devjournal`** | **Anti-Compaction Session Timeline**: Logs progress, saves handoffs, restores full context, and compresses session logs to cut token costs ~90%. | `journal_log`, `journal_handoff`, `journal_resume`, `journal_timeline`, `journal_search`, `journal_compress`, `journal_clear_handoff` |
- | 🛡️ **`checkpoint`** | **Git-Independent Snapshots**: Take 1-second file snapshots before risky AI refactors. Compare diffs and revert instantly without touching your git tree. | `checkpoint_create`, `checkpoint_list`, `checkpoint_diff`, `checkpoint_restore`, `checkpoint_delete` |
- | 🔍 **`context-pack`** | **Autonomous Agent OS**: Token-efficient briefings, dependency blast-radius analysis (`pack_impact`), self-healing preflight checks (`pack_guard`), live log telemetry (`pack_telemetry`), predictive contract diff simulation (`pack_predictive_diff`), and security auditing (`pack_audit`). | `pack_overview`, `pack_tree`, `pack_outline`, `pack_search`, `pack_audit`, `pack_impact`, `pack_guard`, `pack_telemetry`, `pack_predictive_diff` |
- ---
- ### 🧠 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`)
- ```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`)
- ```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`)
- ```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/`](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](docs/privacy.md).
- ---
- ### ☕ 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):
- [](https://saweria.co/sijuling)
- ---
- ### 📄 License
- MIT © Verry Simatupang — see [LICENSE](./LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.