codex-dev-mcp-suite 1.8.1 → 1.8.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +88 -289
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
# Dev MCP Suite
|
|
1
|
+
# Dev MCP Suite 🚀
|
|
2
|
+
|
|
3
|
+
> **Give your AI Coding Assistant Permanent Brain Power & Zero Memory Loss.**
|
|
2
4
|
|
|
3
5
|
[](https://github.com/verrysimatupang99/codex-dev-mcp-suite/actions/workflows/ci.yml)
|
|
4
6
|
[](https://www.npmjs.com/package/codex-dev-mcp-suite)
|
|
@@ -7,105 +9,68 @@
|
|
|
7
9
|
[](https://nodejs.org)
|
|
8
10
|
[](https://saweria.co/sijuling)
|
|
9
11
|
|
|
10
|
-
Published as `codex-dev-mcp-suite
|
|
11
|
-
|
|
12
|
-
Four local, file-based MCP servers for solo developers and vibecoders who keep
|
|
13
|
-
losing context when sessions hit "input too long" / get compacted / restart.
|
|
14
|
-
Stop re-pasting context across sessions.
|
|
12
|
+
Published on npm as `codex-dev-mcp-suite`.
|
|
15
13
|
|
|
16
|
-
|
|
17
|
-
per-project** by the working directory. Works with any MCP-capable client
|
|
18
|
-
(Codex CLI, Claude Code, Cursor, Cline, Gemini-compatible launchers, Hermes,
|
|
19
|
-
or any stdio MCP host).
|
|
14
|
+
---
|
|
20
15
|
|
|
21
|
-
|
|
16
|
+
### 😩 Sound Familiar?
|
|
22
17
|
|
|
23
|
-
|
|
18
|
+
> *"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."*
|
|
24
19
|
|
|
25
|
-
|
|
26
|
-
npx -y -p codex-dev-mcp-suite project-memory-mcp --help
|
|
27
|
-
```
|
|
20
|
+
**Stop re-pasting context over and over.**
|
|
28
21
|
|
|
29
|
-
|
|
30
|
-
keyword recall; model/provider config is optional. For strict no-network mode,
|
|
31
|
-
set `MCP_DETERMINISTIC_FALLBACK=true`.
|
|
22
|
+
**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.
|
|
32
23
|
|
|
33
|
-
|
|
24
|
+
---
|
|
34
25
|
|
|
35
|
-
|
|
36
|
-
# ~/.codex/config.toml
|
|
37
|
-
[mcp_servers.project-memory]
|
|
38
|
-
command = "npx"
|
|
39
|
-
args = ["-y", "-p", "codex-dev-mcp-suite", "project-memory-mcp"]
|
|
26
|
+
### ⚡ Before & After Dev MCP Suite
|
|
40
27
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
28
|
+
| Without Dev MCP Suite 🥱 | With Dev MCP Suite ⚡ |
|
|
29
|
+
|---|---|
|
|
30
|
+
| Re-explaining project setup every time session resets | One-command `journal_resume` recovers context instantly |
|
|
31
|
+
| AI forgets architectural decisions and preferences | Obsidian-compatible Markdown vault retains knowledge permanently |
|
|
32
|
+
| Wasted git commits just to save temporary experiments | Git-independent `checkpoint_create` & instant rollback |
|
|
33
|
+
| Accidental secret/API key leaks committed to GitHub | Built-in `pack_audit` flags missing `.gitignore` & leaked keys |
|
|
34
|
+
| Locked into a proprietary hosted backend | 100% Local-first, zero cloud lock-in, zero telemetry |
|
|
44
35
|
|
|
45
|
-
|
|
46
|
-
command = "npx"
|
|
47
|
-
args = ["-y", "-p", "codex-dev-mcp-suite", "checkpoint-mcp"]
|
|
36
|
+
---
|
|
48
37
|
|
|
49
|
-
|
|
50
|
-
command = "npx"
|
|
51
|
-
args = ["-y", "-p", "codex-dev-mcp-suite", "context-pack-mcp"]
|
|
52
|
-
```
|
|
38
|
+
### ⚡ 10-Second Quickstart
|
|
53
39
|
|
|
54
|
-
|
|
40
|
+
Try it right now without cloning or installing:
|
|
55
41
|
|
|
56
42
|
```bash
|
|
57
|
-
project-memory-mcp --
|
|
58
|
-
project-memory-mcp --doctor # config diagnostics; API keys redacted
|
|
43
|
+
npx -y -p codex-dev-mcp-suite project-memory-mcp --help
|
|
59
44
|
```
|
|
60
45
|
|
|
61
|
-
|
|
62
|
-
[`docs/clients/`](docs/clients/). Full env reference:
|
|
63
|
-
[`docs/configuration.md`](docs/configuration.md). Data flow:
|
|
64
|
-
[`docs/privacy.md`](docs/privacy.md).
|
|
46
|
+
---
|
|
65
47
|
|
|
66
|
-
|
|
48
|
+
### 🛠️ The 4 Superpowers (MCP Servers)
|
|
67
49
|
|
|
68
|
-
| Server |
|
|
50
|
+
| Server | Superpower | Key Tools |
|
|
69
51
|
|---|---|---|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
|
|
75
|
-
## Recall quality (project-memory & devjournal)
|
|
76
|
-
|
|
77
|
-
Recall auto-selects the best available mode:
|
|
78
|
-
|
|
79
|
-
1. **semantic** — if an embeddings endpoint is configured (any OpenAI-compatible `/v1/embeddings`: OpenAI, Ollama, LM Studio, OpenRouter, vLLM, LiteLLM, 9router, ...) or local offline embedding (`MCP_LOCAL_EMBED=true`)
|
|
80
|
-
2. **rerank** — keyword prefilter then an LLM reranker (any OpenAI-compatible chat model)
|
|
81
|
-
3. **keyword** — always-available offline fallback
|
|
52
|
+
| 🧠 **`project-memory`** | **Obsidian-Grade Knowledge Vault**: Persistent Markdown notes, wiki-links (`[[note]]`), MOC generation, and zero-dependency local 384-d vector search (`MCP_LOCAL_EMBED=true`). | `memory_save`, `memory_recall`, `memory_list`, `memory_get`, `memory_link`, `memory_moc`, `memory_graph`, `memory_dedup` |
|
|
53
|
+
| 📜 **`devjournal`** | **Anti-Compaction Session Timeline**: Logs progress, saves handoffs, and restores full context when sessions compact or restart. | `journal_log`, `journal_handoff`, `journal_resume`, `journal_timeline`, `journal_search`, `journal_clear_handoff` |
|
|
54
|
+
| 🛡️ **`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` |
|
|
55
|
+
| 🔍 **`context-pack`** | **Codebase Orientation & Security Audit**: Token-efficient project briefings (stack, symbols, tree) plus instant security auditing to catch leaked secrets. | `pack_overview`, `pack_tree`, `pack_outline`, `pack_search`, `pack_audit` |
|
|
82
56
|
|
|
83
|
-
|
|
84
|
-
Use the neutral `MCP_*` environment variables for new installs; legacy
|
|
85
|
-
`NINEROUTER_*` and `LLM_*` variables are still supported. See
|
|
86
|
-
[`docs/configuration.md`](docs/configuration.md).
|
|
57
|
+
---
|
|
87
58
|
|
|
88
|
-
|
|
89
|
-
embeddings/rerank even if model keys are present; results are labeled
|
|
90
|
-
`[deterministic]`.
|
|
59
|
+
### 🧠 Intelligent Local-First Semantic Search
|
|
91
60
|
|
|
92
|
-
|
|
61
|
+
`memory_recall` automatically selects the best available search engine on your machine:
|
|
93
62
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
63
|
+
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.
|
|
64
|
+
2. **Remote Embeddings (Optional)** — Connect any OpenAI-compatible `/v1/embeddings` endpoint (OpenAI, Cloudflare Workers AI, Ollama, LM Studio, 9router, OpenRouter).
|
|
65
|
+
3. **LLM Reranking (Optional)** — Hybrid keyword pre-filter followed by LLM reranking for high-precision recall.
|
|
66
|
+
4. **Keyword Fallback** — Always-available offline fallback if no network or API keys exist.
|
|
98
67
|
|
|
99
|
-
|
|
68
|
+
---
|
|
100
69
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
### Quickest: run via npx (no clone)
|
|
104
|
-
|
|
105
|
-
Point your MCP client at the published package — no install step needed:
|
|
70
|
+
### 🔌 Plug & Play with Any MCP Client
|
|
106
71
|
|
|
72
|
+
#### 1. Codex CLI (`~/.codex/config.toml`)
|
|
107
73
|
```toml
|
|
108
|
-
# Codex CLI ~/.codex/config.toml
|
|
109
74
|
[mcp_servers.project-memory]
|
|
110
75
|
command = "npx"
|
|
111
76
|
args = ["-y", "-p", "codex-dev-mcp-suite", "project-memory-mcp"]
|
|
@@ -123,239 +88,73 @@ command = "npx"
|
|
|
123
88
|
args = ["-y", "-p", "codex-dev-mcp-suite", "context-pack-mcp"]
|
|
124
89
|
```
|
|
125
90
|
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
91
|
+
#### 2. Hermes Agent (`~/.hermes/config.yaml`)
|
|
92
|
+
```yaml
|
|
93
|
+
mcp_servers:
|
|
94
|
+
project-memory:
|
|
95
|
+
command: project-memory-mcp
|
|
96
|
+
env:
|
|
97
|
+
MCP_LOCAL_EMBED: "true"
|
|
98
|
+
devjournal:
|
|
99
|
+
command: devjournal-mcp
|
|
100
|
+
checkpoint:
|
|
101
|
+
command: checkpoint-mcp
|
|
102
|
+
context-pack:
|
|
103
|
+
command: context-pack-mcp
|
|
136
104
|
```
|
|
137
105
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
```toml
|
|
149
|
-
[mcp_servers.project-memory]
|
|
150
|
-
command = "node"
|
|
151
|
-
args = ["/abs/path/codex-dev-mcp-suite/project-memory/server.js"]
|
|
152
|
-
[mcp_servers.project-memory.env]
|
|
153
|
-
MEMORY_VAULT_DIR = "~/.codex/memories/vault"
|
|
154
|
-
# optional recall upgrades (see .env.example and docs/configuration.md)
|
|
155
|
-
# MCP_LLM_BASE_URL = "http://localhost:11434/v1" # any OpenAI-compatible endpoint
|
|
156
|
-
# MCP_LLM_API_KEY = "..."
|
|
157
|
-
# MCP_RERANK_MODEL = "llama3.1:8b"
|
|
158
|
-
|
|
159
|
-
[mcp_servers.checkpoint]
|
|
160
|
-
command = "node"
|
|
161
|
-
args = ["/abs/path/codex-dev-mcp-suite/checkpoint/server.js"]
|
|
162
|
-
|
|
163
|
-
[mcp_servers.context-pack]
|
|
164
|
-
command = "node"
|
|
165
|
-
args = ["/abs/path/codex-dev-mcp-suite/context-pack/server.js"]
|
|
166
|
-
|
|
167
|
-
[mcp_servers.devjournal]
|
|
168
|
-
command = "node"
|
|
169
|
-
args = ["/abs/path/codex-dev-mcp-suite/devjournal/server.js"]
|
|
170
|
-
[mcp_servers.devjournal.env]
|
|
171
|
-
JOURNAL_DIR = "~/.codex/memories/journal"
|
|
106
|
+
#### 3. Google Antigravity CLI / Cursor / Claude Code (`mcp.json`)
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"mcpServers": {
|
|
110
|
+
"project-memory": { "command": "project-memory-mcp", "env": { "MCP_LOCAL_EMBED": "true" } },
|
|
111
|
+
"devjournal": { "command": "devjournal-mcp" },
|
|
112
|
+
"checkpoint": { "command": "checkpoint-mcp" },
|
|
113
|
+
"context-pack": { "command": "context-pack-mcp" }
|
|
114
|
+
}
|
|
115
|
+
}
|
|
172
116
|
```
|
|
173
117
|
|
|
174
|
-
|
|
175
|
-
idea — use the npm bin commands (`project-memory-mcp`, `devjournal-mcp`,
|
|
176
|
-
`checkpoint-mcp`, `context-pack-mcp`) or `node /abs/path/<server>/server.js`,
|
|
177
|
-
with optional `env`.
|
|
118
|
+
👉 See detailed client setup guides in [`docs/clients/`](docs/clients/).
|
|
178
119
|
|
|
179
|
-
|
|
120
|
+
---
|
|
180
121
|
|
|
181
|
-
|
|
122
|
+
### 🚀 Daily Solo Developer Workflow
|
|
182
123
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
| `keyword` | Skip embedding entirely (faster, pure keyword scoring) |
|
|
124
|
+
- **Session Start**: Run `pack_overview` + `journal_resume` + `memory_recall "<topic>"` to get oriented in seconds.
|
|
125
|
+
- **Before Risky Changes**: Run `checkpoint_create` to create a safe recovery point.
|
|
126
|
+
- **While Coding**: Run `memory_save` to store architectural decisions, and `pack_audit` before committing.
|
|
127
|
+
- **Session End / Compaction**: Run `journal_handoff` so your next session picks up right where you left off.
|
|
188
128
|
|
|
189
|
-
|
|
129
|
+
---
|
|
190
130
|
|
|
191
|
-
|
|
192
|
-
Recall for "how do users sign in" in my-project [semantic+rerank]:
|
|
193
|
-
### JWT login flow (id:..., sim:0.603, ...)
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
The `+rerank` suffix is appended when LLM rerank is active (MCP_RERANK_ENABLED + key).
|
|
197
|
-
Without embeddings, recall falls back to `[keyword]` or `[keyword+rerank]`.
|
|
198
|
-
With `MCP_DETERMINISTIC_FALLBACK=true`, the mode is always `[deterministic]`.
|
|
131
|
+
### 📊 Utility CLIs Included
|
|
199
132
|
|
|
200
|
-
|
|
201
|
-
`memory_recall` still works via keyword scoring, just no semantic similarity.
|
|
133
|
+
Install globally with `npm i -g codex-dev-mcp-suite` to access built-in maintenance tools:
|
|
202
134
|
|
|
203
|
-
|
|
135
|
+
- `stats` — View total notes, journal activity, and storage stats across all projects (`stats --json`).
|
|
136
|
+
- `prune` — Safely clean up temporary project scratch files (`prune --yes`).
|
|
137
|
+
- `provider-smoke` — Probe configured LLM providers (chat & embedding endpoints) for health and latency.
|
|
204
138
|
|
|
205
|
-
|
|
139
|
+
---
|
|
206
140
|
|
|
207
|
-
|
|
208
|
-
- `memory_global_recall` searches across projects with same-project bias and graceful keyword fallback
|
|
209
|
-
- `memory_dedup` suggests duplicate-note merges without deleting anything
|
|
141
|
+
### 🔒 Privacy & Local-First Philosophy
|
|
210
142
|
|
|
211
|
-
|
|
143
|
+
- **Zero Cloud Backend**: Everything is saved locally as plain Markdown & JSON files on your hard drive (`~/.ai-shared-memory` or project directory).
|
|
144
|
+
- **Zero Telemetry**: No tracking, no user accounts, no phoning home.
|
|
145
|
+
- **Network Isolation Ready**: Set `MCP_DETERMINISTIC_FALLBACK=true` for 100% air-gapped, offline operations.
|
|
146
|
+
- See detailed [privacy and data flow documentation](docs/privacy.md).
|
|
212
147
|
|
|
213
|
-
|
|
148
|
+
---
|
|
214
149
|
|
|
215
|
-
|
|
216
|
-
- Before a risky change: `checkpoint_create`
|
|
217
|
-
- While working: `memory_save` (durable facts), `journal_log` (events/blockers)
|
|
218
|
-
- Session end / before compaction: `journal_handoff`
|
|
150
|
+
### ☕ Support / Donasi
|
|
219
151
|
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
`backfill-sessions-v2.mjs` reads `~/.codex/sessions/*.jsonl` and imports each
|
|
223
|
-
session (prompts, plan, commands, files touched) into project-memory + devjournal,
|
|
224
|
-
grouped by project, backdated to the original session time.
|
|
225
|
-
|
|
226
|
-
```bash
|
|
227
|
-
node backfill-sessions-v2.mjs --dry --min-prompts 2 # preview
|
|
228
|
-
node backfill-sessions-v2.mjs --min-prompts 2 # import
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
## Stats CLI
|
|
232
|
-
|
|
233
|
-
A read-only summary of your local memory storage — totals, top projects,
|
|
234
|
-
recent activity, and temp-slug cleanup candidates.
|
|
235
|
-
|
|
236
|
-
```bash
|
|
237
|
-
npx -y -p codex-dev-mcp-suite stats # human-readable
|
|
238
|
-
npx -y -p codex-dev-mcp-suite stats --json # machine-readable
|
|
239
|
-
npx -y -p codex-dev-mcp-suite stats --root /tmp/mem # different root
|
|
240
|
-
npx -y -p codex-dev-mcp-suite stats --top 5 # trim top lists
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
Example output:
|
|
244
|
-
|
|
245
|
-
```
|
|
246
|
-
Dev MCP Suite — stats
|
|
247
|
-
======================
|
|
248
|
-
Storage root: /home/you/.codex/memories
|
|
249
|
-
|
|
250
|
-
Totals
|
|
251
|
-
------
|
|
252
|
-
Notes: 89
|
|
253
|
-
Journal projects:19
|
|
254
|
-
Checkpoints: 1
|
|
255
|
-
Distinct projects: 25
|
|
256
|
-
|
|
257
|
-
Top projects by notes (top 10)
|
|
258
|
-
------------------------
|
|
259
|
-
24 mrtrickster99-fd1ff0fa
|
|
260
|
-
14 Coding-17e063ef
|
|
261
|
-
...
|
|
262
|
-
|
|
263
|
-
Temp/cleanup candidates (2)
|
|
264
|
-
------------------------
|
|
265
|
-
tmp.itbtDn9eB3-b62798fd
|
|
266
|
-
tmp.iHqM2Uh5K2-8d3660a2
|
|
267
|
-
```
|
|
268
|
-
|
|
269
|
-
The CLI is a thin wrapper around `lib/stats.js`, which is also importable
|
|
270
|
-
directly from your own scripts. The default storage root is
|
|
271
|
-
`~/.codex/memories`, but `--root` (or the existing `MEMORY_VAULT_DIR` /
|
|
272
|
-
`JOURNAL_DIR` / `CHECKPOINT_DIR` env vars) override it.
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
## Provider Smoke CLI
|
|
276
|
-
|
|
277
|
-
Verify every configured LLM provider (chat + embeddings) with one command.
|
|
278
|
-
Useful after adding a new API key, or when comparing provider latency.
|
|
279
|
-
|
|
280
|
-
```bash
|
|
281
|
-
npx -y -p codex-dev-mcp-suite provider-smoke # uses process.env
|
|
282
|
-
npx -y -p codex-dev-mcp-suite provider-smoke --env-file ~/secrets.env # separate secrets file
|
|
283
|
-
npx -y -p codex-dev-mcp-suite provider-smoke --markdown --save-md docs/providers.md
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
Auto-detects providers from these env vars (highest precedence first):
|
|
287
|
-
|
|
288
|
-
- **Numbered slots**: `MCP_PROVIDER_PRIMARY` / `_CHAIN2` / `_CHAIN3` / ...
|
|
289
|
-
- **Named env**: `GROQ_*`, `CEREBRAS_*`, `MISTRAL_*`, `OPENROUTER_*`, `OPENAI_*`, `GEMINI_*`, `COHERE_*`, `VOYAGE_*`, `OLLAMA_*`, `ANTHROPIC_*`
|
|
290
|
-
- **Catch-all**: `MCP_LLM_BASE_URL` / `MCP_RERANK_BASE_URL` / `MCP_EMBED_BASE_URL` / `NINEROUTER_URL` / `LLM_BASE_URL` (any OpenAI-compatible endpoint)
|
|
291
|
-
|
|
292
|
-
For each detected provider, runs:
|
|
293
|
-
- **chat probe** (`/v1/chat/completions`) — if the provider supports it
|
|
294
|
-
- **embed probe** (`/v1/embeddings`) — if the provider supports it
|
|
295
|
-
|
|
296
|
-
**Inference-only providers** (Groq, Cerebras, Anthropic) skip the embed probe automatically.
|
|
297
|
-
**Non-OpenAI-compatible providers** (Cloudflare Workers AI) require a custom code path in
|
|
298
|
-
`project-memory/embedding.js` — see [docs/providers.md](docs/providers.md).
|
|
299
|
-
|
|
300
|
-
**No provider assumption is baked in**: the tool only probes what's in your env. Zero-config users
|
|
301
|
-
get an empty matrix; pass `--env-file` to point at a secrets file.
|
|
302
|
-
|
|
303
|
-
Chat-only providers (Groq, Cerebras) skip the embeddings probe automatically
|
|
304
|
-
— they don't expose `/v1/embeddings`. Embedding-capable providers (Mistral,
|
|
305
|
-
OpenRouter, OpenAI, Ollama, Gemini, Cohere) run both probes.
|
|
306
|
-
|
|
307
|
-
Example output (Groq + Cerebras, both configured):
|
|
308
|
-
|
|
309
|
-
```
|
|
310
|
-
[groq]
|
|
311
|
-
✓ chat 200 310ms "OK"
|
|
312
|
-
|
|
313
|
-
[cerebras]
|
|
314
|
-
✓ chat 200 476ms
|
|
315
|
-
```
|
|
316
|
-
|
|
317
|
-
See [`docs/providers.md`](docs/providers.md) for a saved smoke matrix.
|
|
318
|
-
|
|
319
|
-
## Prune CLI
|
|
320
|
-
|
|
321
|
-
Remove temp project slugs (prefix `tmp.`) from vault / journal / checkpoints.
|
|
322
|
-
Default is DRY-RUN — nothing is deleted without `--yes`.
|
|
323
|
-
|
|
324
|
-
```bash
|
|
325
|
-
npx -y -p codex-dev-mcp-suite prune # dry-run report
|
|
326
|
-
npx -y -p codex-dev-mcp-suite prune --yes # actually delete
|
|
327
|
-
npx -y -p codex-dev-mcp-suite prune --json # machine-readable
|
|
328
|
-
npx -y -p codex-dev-mcp-suite prune --root /tmp/mem # different root
|
|
329
|
-
```
|
|
330
|
-
|
|
331
|
-
Safety: refuses to delete any slug that does not start with `tmp.`. Useful
|
|
332
|
-
right after heavy refactors or after imports that left tmp scratch dirs.
|
|
333
|
-
|
|
334
|
-
For in-session use from an MCP client, the project-memory server exposes a
|
|
335
|
-
`memory_stats` tool that returns the same summary text (or JSON) as the `stats`
|
|
336
|
-
CLI above.
|
|
337
|
-
|
|
338
|
-
## Tests
|
|
339
|
-
|
|
340
|
-
```bash
|
|
341
|
-
node run-tests.mjs # all servers (offline, ~27 tests)
|
|
342
|
-
cd project-memory && npm test
|
|
343
|
-
```
|
|
344
|
-
|
|
345
|
-
## Privacy
|
|
346
|
-
|
|
347
|
-
Local-first by default: no hosted backend, no built-in telemetry, no project
|
|
348
|
-
account system. Everything is stored as files on your machine. No data leaves
|
|
349
|
-
your machine unless you explicitly configure an external model/API endpoint for
|
|
350
|
-
rerank or embeddings. See [privacy and data flow](docs/privacy.md). Your
|
|
351
|
-
personal vault/journal/checkpoints are gitignored.
|
|
352
|
-
|
|
353
|
-
## ☕ Support / Donasi
|
|
354
|
-
|
|
355
|
-
Jika `codex-dev-mcp-suite` bermanfaat untuk produktivitas pengkodean Anda, dukung pengembangan proyek open-source ini melalui Saweria (QRIS, GoPay, DANA, OVO, ShopeePay):
|
|
152
|
+
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):
|
|
356
153
|
|
|
357
154
|
[](https://saweria.co/sijuling)
|
|
358
155
|
|
|
359
|
-
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
### 📄 License
|
|
360
159
|
|
|
361
|
-
MIT — see [LICENSE](./LICENSE).
|
|
160
|
+
MIT © Verry Simatupang — see [LICENSE](./LICENSE).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "codex-dev-mcp-suite",
|
|
3
|
-
"version": "1.8.
|
|
3
|
+
"version": "1.8.2",
|
|
4
4
|
"description": "Four local, file-based MCP servers for solo devs/vibecoders: persistent project memory, session handoff/resume, git-independent file checkpoints, and token-efficient project briefings. Works with any MCP client.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|