Skip to content

Commit 3259606

Browse files
Claudeclaude
authored and
CLC
committed
fix: use gitmem-mcp@latest in all MCP configs to prevent stale npx cache
npx -y gitmem-mcp can serve a cached older version indefinitely. Adding @latest forces npm to resolve the newest published version on every MCP server startup. Updated: init wizard, configure command, README, docs, llms.txt, directory submissions, test plans, and distribution configs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 16290b3 commit 3259606

14 files changed

Lines changed: 173 additions & 22 deletions

File tree

‎DIRECTORY-SUBMISSIONS.md‎

Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
1+
# MCP Directory Submission Copy
2+
3+
Reusable copy for submitting gitmem-mcp to MCP directories. Not published — internal reference only.
4+
5+
---
6+
7+
## Short Description (one-liner)
8+
9+
Institutional memory for AI coding agents. Your agent remembers mistakes, successes, and decisions across sessions — so it learns from experience instead of starting from scratch.
10+
11+
## Medium Description (2-3 sentences)
12+
13+
GitMem is an MCP server that gives AI coding agents persistent memory across sessions. It tracks mistakes (scars), successes (wins), architectural decisions, and unfinished work — surfacing relevant lessons before the agent takes action. One command setup: `npx gitmem-mcp init`.
14+
15+
## Key Features (bullet points)
16+
17+
- Persistent memory across coding sessions — mistakes, wins, decisions, and open threads
18+
- Automatic recall — relevant lessons surface before the agent repeats past errors
19+
- Session continuity with structured closing ceremony that captures what broke and what worked
20+
- 20+ MCP tools for memory management, search, threads, and multi-agent coordination
21+
- Zero config setup: `npx gitmem-mcp init` auto-detects your IDE
22+
- Local-first, no telemetry — all data in `.gitmem/` on your machine
23+
- Works with Claude Code, Cursor, VS Code (Copilot), Windsurf, and any MCP client
24+
25+
## Tags/Categories
26+
27+
`ai-memory`, `ai-agent`, `coding`, `developer-tools`, `productivity`, `knowledge-management`, `mcp-server`
28+
29+
## Links
30+
31+
- **npm:** https://www.npmjs.com/package/gitmem-mcp
32+
- **GitHub:** https://github.com/gitmem-dev/gitmem
33+
- **Website:** https://gitmem.ai
34+
- **Docs:** https://gitmem.ai/docs
35+
36+
## Install
37+
38+
```json
39+
{
40+
"mcpServers": {
41+
"gitmem": {
42+
"command": "npx",
43+
"args": ["-y", "gitmem-mcp@latest"]
44+
}
45+
}
46+
}
47+
```
48+
49+
---
50+
51+
## Per-Directory Submissions
52+
53+
### 1. mcp.so — GitHub Issue
54+
55+
**Title:** Add GitMem — Institutional memory for AI coding agents
56+
57+
**Body:**
58+
59+
**Server Name:** GitMem
60+
61+
**Description:** Institutional memory for AI coding agents. Your agent remembers mistakes (scars), successes (wins), and decisions across sessions — surfacing relevant lessons before repeating past errors. One command setup, local-first, no telemetry.
62+
63+
**GitHub:** https://github.com/gitmem-dev/gitmem
64+
65+
**npm:** https://www.npmjs.com/package/gitmem-mcp
66+
67+
**Website:** https://gitmem.ai
68+
69+
**Features:**
70+
- Persistent memory across coding sessions (scars, wins, decisions, threads)
71+
- Automatic recall — surfaces relevant warnings before similar actions
72+
- Session continuity with structured reflection
73+
- 20+ MCP tools
74+
- Works with Claude Code, Cursor, VS Code (Copilot), Windsurf
75+
- Zero config: `npx gitmem-mcp init`
76+
- Local-first, no telemetry, MIT licensed
77+
78+
**Install:**
79+
```json
80+
{
81+
"mcpServers": {
82+
"gitmem": {
83+
"command": "npx",
84+
"args": ["-y", "gitmem-mcp@latest"]
85+
}
86+
}
87+
}
88+
```
89+
90+
**Categories:** Developer Tools, Productivity, Knowledge Management
91+
92+
---
93+
94+
### 2. Smithery — Registry Listing
95+
96+
Smithery pulls from GitHub repos. May need a `smithery.yaml` in the repo root. Research the exact format before creating.
97+
98+
**Server Name:** gitmem
99+
**Display Name:** GitMem
100+
**Description:** Institutional memory for AI coding agents. Remembers mistakes, successes, and decisions across sessions.
101+
102+
---
103+
104+
### 3. Glama — Add Server Form
105+
106+
**Server Name:** GitMem
107+
**GitHub URL:** https://github.com/gitmem-dev/gitmem
108+
**Description:** MCP server that gives AI coding agents persistent memory across sessions. Tracks mistakes (scars), successes (wins), and architectural decisions. Surfaces relevant lessons before the agent takes action. Zero config: `npx gitmem-mcp init`.
109+
**Email:** dev@gitmem.ai
110+
111+
---
112+
113+
### 4. Cline Marketplace — GitHub Issue
114+
115+
**Title:** Add GitMem — Institutional memory for AI coding agents
116+
117+
**Body:**
118+
119+
**GitHub Repo URL:** https://github.com/gitmem-dev/gitmem
120+
121+
**Logo:** (attach logo-400.png — 400x400 PNG)
122+
123+
**Reason for Addition:**
124+
GitMem gives Cline persistent memory across sessions. Instead of starting from scratch each time, Cline remembers past mistakes (scars), successes (wins), and architectural decisions. Before taking action, relevant lessons automatically surface — preventing repeated errors.
125+
126+
Key benefits for Cline users:
127+
- `npx gitmem-mcp init` auto-detects Cline and sets up everything
128+
- Scars prevent repeating the same debugging cycles
129+
- Session threads carry unfinished work across sessions
130+
- Local-first, no telemetry, MIT licensed
131+
132+
Setup tested with Cline using README.md — installs and configures without issues.
133+
134+
---
135+
136+
### 5. mcpservers.org (Awesome MCP Servers)
137+
138+
Likely a GitHub PR to add an entry. Check their repo structure before submitting.
139+
140+
**Entry:**
141+
- **GitMem** — Institutional memory for AI coding agents. Persistent scars, wins, decisions, and session continuity. `npx gitmem-mcp init`. [GitHub](https://github.com/gitmem-dev/gitmem)
142+
143+
---
144+
145+
### 6. MCP Market (mcpmarket.com)
146+
147+
**Server Name:** GitMem
148+
**Description:** Institutional memory for AI coding agents. Remembers mistakes, successes, and decisions across sessions — surfacing relevant lessons before repeating past errors.
149+
**GitHub:** https://github.com/gitmem-dev/gitmem
150+
**npm:** gitmem-mcp
151+
**Categories:** Developer Tools, Productivity

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ Add this to your MCP client's config file:
101101
"mcpServers": {
102102
"gitmem": {
103103
"command": "npx",
104-
"args": ["-y", "gitmem-mcp"]
104+
"args": ["-y", "gitmem-mcp@latest"]
105105
}
106106
}
107107
}

‎apps/docs/content/docs/getting-started/installation.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ If you want to configure the MCP server without the init wizard.
110110
<Tab value="Claude Code">
111111

112112
```bash
113-
claude mcp add gitmem -- npx -y gitmem-mcp
113+
claude mcp add gitmem -- npx -y gitmem-mcp@latest
114114
```
115115

116116
</Tab>
@@ -123,7 +123,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
123123
"mcpServers": {
124124
"gitmem": {
125125
"command": "npx",
126-
"args": ["-y", "gitmem-mcp"]
126+
"args": ["-y", "gitmem-mcp@latest"]
127127
}
128128
}
129129
}
@@ -143,7 +143,7 @@ Add to `.cursor/mcp.json` in your project:
143143
"mcpServers": {
144144
"gitmem": {
145145
"command": "npx",
146-
"args": ["-y", "gitmem-mcp"]
146+
"args": ["-y", "gitmem-mcp@latest"]
147147
}
148148
}
149149
}

‎apps/docs/public/llms-full.txt‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1560,7 +1560,7 @@ If you want to configure the MCP server without the init wizard.
15601560
<Tab value="Claude Code">
15611561

15621562
```bash
1563-
claude mcp add gitmem -- npx -y gitmem-mcp
1563+
claude mcp add gitmem -- npx -y gitmem-mcp@latest
15641564
```
15651565

15661566
</Tab>
@@ -1573,7 +1573,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
15731573
"mcpServers": {
15741574
"gitmem": {
15751575
"command": "npx",
1576-
"args": ["-y", "gitmem-mcp"]
1576+
"args": ["-y", "gitmem-mcp@latest"]
15771577
}
15781578
}
15791579
}
@@ -1593,7 +1593,7 @@ Add to `.cursor/mcp.json` in your project:
15931593
"mcpServers": {
15941594
"gitmem": {
15951595
"command": "npx",
1596-
"args": ["-y", "gitmem-mcp"]
1596+
"args": ["-y", "gitmem-mcp@latest"]
15971597
}
15981598
}
15991599
}

‎apps/docs/public/llms.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Add GitMem to any MCP-compatible AI agent:
1111
cd your-project && npx gitmem-mcp init
1212

1313
# Or add the MCP server directly
14-
claude mcp add gitmem -- npx -y gitmem-mcp
14+
claude mcp add gitmem -- npx -y gitmem-mcp@latest
1515
```
1616

1717
Manual MCP config (works with any MCP client):
@@ -21,7 +21,7 @@ Manual MCP config (works with any MCP client):
2121
"mcpServers": {
2222
"gitmem": {
2323
"command": "npx",
24-
"args": ["-y", "gitmem-mcp"]
24+
"args": ["-y", "gitmem-mcp@latest"]
2525
}
2626
}
2727
}

‎apps/docs/scripts/generate-llms-txt.ts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ Add GitMem to any MCP-compatible AI agent:
113113
cd your-project && npx gitmem-mcp init
114114
115115
# Or add the MCP server directly
116-
claude mcp add gitmem -- npx -y gitmem-mcp
116+
claude mcp add gitmem -- npx -y gitmem-mcp@latest
117117
\`\`\`
118118
119119
Manual MCP config (works with any MCP client):
@@ -123,7 +123,7 @@ Manual MCP config (works with any MCP client):
123123
"mcpServers": {
124124
"gitmem": {
125125
"command": "npx",
126-
"args": ["-y", "gitmem-mcp"]
126+
"args": ["-y", "gitmem-mcp@latest"]
127127
}
128128
}
129129
}

‎bin/gitmem.js‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -313,7 +313,7 @@ function cmdConfigure() {
313313
mcpServers: {
314314
gitmem: {
315315
command: "npx",
316-
args: ["-y", "gitmem-mcp"],
316+
args: ["-y", "gitmem-mcp@latest"],
317317
},
318318
},
319319
};
@@ -332,7 +332,7 @@ function cmdConfigure() {
332332
mcpServers: {
333333
gitmem: {
334334
command: "npx",
335-
args: ["-y", "gitmem-mcp"],
335+
args: ["-y", "gitmem-mcp@latest"],
336336
env: {
337337
SUPABASE_URL: "https://YOUR_PROJECT.supabase.co",
338338
SUPABASE_SERVICE_ROLE_KEY: "eyJ...",

‎bin/init-wizard.js‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -253,11 +253,11 @@ function log(icon, main, detail) {
253253
function buildMcpConfig() {
254254
const supabaseUrl = process.env.SUPABASE_URL;
255255
if (!supabaseUrl) {
256-
return { command: "npx", args: ["-y", "gitmem-mcp"] };
256+
return { command: "npx", args: ["-y", "gitmem-mcp@latest"] };
257257
}
258258
return {
259259
command: "npx",
260-
args: ["-y", "gitmem-mcp"],
260+
args: ["-y", "gitmem-mcp@latest"],
261261
env: {
262262
SUPABASE_URL: supabaseUrl,
263263
SUPABASE_SERVICE_ROLE_KEY:

‎distribution/openclaw/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Or add manually to `~/.openclaw/mcp.json`:
2727
"mcpServers": {
2828
"gitmem": {
2929
"command": "npx",
30-
"args": ["-y", "gitmem-mcp"]
30+
"args": ["-y", "gitmem-mcp@latest"]
3131
}
3232
}
3333
}

‎testing/clean-room/CURSOR-TEST-PLAN.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ cat .gitmem/learnings.json | jq '. | length'
126126

127127
# MCP config — Cursor-specific path
128128
cat .cursor/mcp.json | jq .
129-
# Expected: mcpServers.gitmem with command "npx" and args ["-y", "gitmem-mcp"]
129+
# Expected: mcpServers.gitmem with command "npx" and args ["-y", "gitmem-mcp@latest"]
130130

131131
# Instructions file — .cursorrules, NOT CLAUDE.md
132132
cat .cursorrules

0 commit comments

Comments
 (0)