@cachly-dev/mcp-server 0.5.43 → 0.5.45

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/CHANGELOG.md ADDED
@@ -0,0 +1,97 @@
1
+ # Changelog – cachly SDK (mcp)
2
+
3
+ **Language:** MCP (Model Context Protocol)
4
+ **Package:** `@cachly-dev/mcp-server` on **npm**
5
+
6
+ > Full cross-SDK release notes: [../CHANGELOG.md](../CHANGELOG.md)
7
+
8
+ ---
9
+
10
+ ## [0.5.37] – 2026-04-24
11
+
12
+ ### Added
13
+
14
+ - **RTL language support (Arabic, Hebrew)** — word-level tokenization with Unicode ranges U+0590–U+05FF (Hebrew) and U+0600–U+06FF (Arabic); Arabic light stemmer strips definite article `ال` and single-char prefix particles (`و`,`ب`,`ل`,`ف`,`ك`)
15
+ - **Arabic and Hebrew stopwords** — ~60 high-frequency function words per language added to the STOPWORDS set
16
+ - **Romanization matching** — katakana segments now additionally emit Hepburn romaji tokens at index time (e.g. `デプロイ` → `depuroi`), so users can query Japanese docs using romaji
17
+ - **Full katakana→romaji converter** — handles digraphs (シャ→sha, チェ→che, ファ→fa), voiced consonants, geminate consonants (ッ), long vowel marks (ー), and loanword combinations
18
+ - **Cross-language retrieval** — 130+ tech term synonyms spanning EN↔JA↔ZH↔KO↔AR↔HE; searching `deploy` now finds docs containing `デプロイ`, `部署`, `배포` and vice versa; applies bidirectionally at tokenize time (zero runtime overhead)
19
+ - **73 unit tests** all passing — new test suites for `katakanaToRomaji`, `arabicLightStem`, `expandCrossLingual`, RTL tokenization, and cross-lingual expansion
20
+
21
+ ---
22
+
23
+ ## [0.5.36] – 2026-04-22
24
+
25
+ ### Added
26
+
27
+ - **Roadmap tools** — `roadmap_add`, `roadmap_update`, `roadmap_list`, `roadmap_next` for persistent project planning inside the Brain
28
+ - `session_start` now shows open roadmap items automatically
29
+
30
+ ---
31
+
32
+ ## [0.5.35] – 2026-04-20
33
+
34
+ ### Added
35
+
36
+ - **CJK language support** — Chinese (Simplified + Traditional), Japanese, Korean
37
+ - Character bigram extraction for CJK Unicode ranges
38
+ - ~140 CJK stopwords (Chinese particles, Japanese hiragana particles, Korean postpositions)
39
+
40
+ ---
41
+
42
+
43
+
44
+ ### Added
45
+
46
+ - **`setup` command** — interactive zero-arg CLI wizard (`npx @cachly-dev/mcp-server setup`):
47
+ - Reads `CACHLY_JWT` from env or prompts interactively via readline
48
+ - Fetches instances from API; presents list when multiple exist
49
+ - Auto-detects installed editors (Cursor, Windsurf, VS Code, Continue.dev) by checking for their config directories
50
+ - Writes the correct MCP config file for each detected editor in one step
51
+ - Always writes/updates `CLAUDE.md` (idempotent via `<!-- cachly-brain-start/end -->` markers)
52
+ - **`init` command** now idempotent — re-running `npx @cachly-dev/mcp-server init` updates the brain block in `CLAUDE.md` instead of appending a duplicate
53
+ - Shared helpers: `buildMcpConfig()`, `buildClaudeMdBlock()`, `writeClaudeMd()` — used by both `setup` and `init`
54
+
55
+ ### Fixed
56
+
57
+ - `init` no longer duplicates the brain block in `CLAUDE.md` when run multiple times
58
+ - Correct package name `@cachly-dev/mcp-server` used consistently (was `@cachly-dev/mcp` in generated configs)
59
+
60
+ ---
61
+
62
+ ## [0.1.1] – 2026-04-07
63
+
64
+ ### Fixed
65
+
66
+ - Broken `index_project` tool schema – properties were accidentally placed outside the `TOOLS` array
67
+ - Unused `openai` variable removed from `cache_warmup` handler
68
+ - `readdir` type mismatch (`Dirent<string>` vs. `NonSharedBuffer`) fixed
69
+ - Version bumped to `0.3.0` in server metadata
70
+
71
+ ---
72
+
73
+ ## [0.1.0] – 2026-04-07
74
+
75
+ Initial release.
76
+
77
+ ### Added
78
+
79
+ - MCP tool: `cache_set` – store a value with optional TTL
80
+ - MCP tool: `cache_get` – retrieve a cached value
81
+ - MCP tool: `cache_delete` – remove a key
82
+ - MCP tool: `semantic_search` – vector-similarity lookup for LLM response caching
83
+ - MCP tool: `cache_clear` – flush namespace or entire cache
84
+ - Compatible with Claude Desktop, Cursor, Windsurf, and any MCP-capable host
85
+ - API-key-based authentication
86
+ - EU data residency (German servers, DSGVO compliant)
87
+
88
+ ### Known limitations
89
+
90
+ - ~~Streaming tools not yet supported~~ (tracked for a future release)
91
+
92
+ ---
93
+
94
+ ## [Unreleased]
95
+
96
+ See [../CHANGELOG.md](../CHANGELOG.md) for upcoming features.
97
+
package/Dockerfile CHANGED
@@ -1,19 +1,16 @@
1
- FROM node:22-alpine
1
+ FROM node:22-alpine AS builder
2
2
  WORKDIR /app
3
-
4
- # Install dependencies
5
- COPY package*.json ./
6
- RUN npm ci
7
-
8
- # Build TypeScript
3
+ COPY package*.json tsconfig*.json ./
4
+ RUN npm ci --ignore-scripts
9
5
  COPY src/ ./src/
10
- COPY tsconfig.json ./
11
- RUN npm run build && npm prune --omit=dev
12
-
13
- # MCP servers communicate over stdio — no port needed
14
- ENV CACHLY_JWT=""
15
- ENV CACHLY_INSTANCE_ID=""
16
- ENV CACHLY_NO_TELEMETRY=1
17
- ENV CACHLY_NO_UPDATE_CHECK=1
6
+ RUN npm run build
18
7
 
8
+ FROM node:22-alpine
9
+ WORKDIR /app
10
+ COPY package*.json ./
11
+ RUN npm ci --omit=dev --ignore-scripts
12
+ COPY --from=builder /app/dist/ ./dist/
13
+ ENV NODE_ENV=production
14
+ ENV PORT=3000
15
+ EXPOSE 3000
19
16
  ENTRYPOINT ["node", "dist/index.js"]
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
- # cachly — Give Your AI a Permanent Brain
1
+ # 🧠 cachly AI Brain — MCP Server
2
2
 
3
- > **Claude forgets everything when the session ends.**
4
- > cachly doesn't. Every fix, every lesson, every architecture decision — loaded in 2 seconds at the start of every session. Forever.
3
+ > **Persistent memory for Claude Code, Cursor, GitHub Copilot, Windsurf, Cline & Zed.**
4
+ > Your AI remembers every lesson, every fix, every architecture decision — forever.
5
5
 
6
6
  <p align="center">
7
- <a href="https://github.com/cachly-dev/cachly-mcp/stargazers">
8
- <img src="https://img.shields.io/github/stars/cachly-dev/cachly-mcp?style=social" alt="GitHub Stars" />
7
+ <a href="https://github.com/cachly-dev/mcp-server/stargazers">
8
+ <img src="https://img.shields.io/github/stars/cachly-dev/mcp-server?style=social" alt="GitHub Stars" />
9
9
  </a>
10
10
  &nbsp;
11
11
  <a href="https://www.npmjs.com/package/@cachly-dev/mcp-server">
@@ -23,123 +23,204 @@
23
23
  <a href="https://cachly.dev/legal">
24
24
  <img src="https://img.shields.io/badge/GDPR-EU%20only-green" alt="GDPR: EU only" />
25
25
  </a>
26
+ &nbsp;
27
+ <img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
26
28
  </p>
27
29
 
28
30
  ---
29
31
 
30
- ## One command. Permanent memory. No copy-paste.
32
+ ## The Problem
33
+
34
+ Every morning, you open your AI coding assistant. It doesn't remember yesterday.
35
+ You explain your architecture. You explain the deployment process. You explain the bug you fixed last week.
36
+
37
+ **The average developer wastes 45 minutes/day re-establishing context.** That's €15,000+ in lost productivity per engineer per year.
38
+
39
+ ## The Fix — One Command
31
40
 
32
41
  ```bash
33
42
  npx @cachly-dev/mcp-server@latest setup
34
43
  ```
35
44
 
36
- Browser opens → sign in → Brain provisioned → every editor configured automatically.
37
- No dashboard visit. No API keys to copy. No instance IDs to manage.
45
+ The interactive wizard:
46
+ 1. Signs you in (free, no credit card required)
47
+ 2. Picks or creates your AI Brain instance
48
+ 3. **Auto-detects** Cursor, Windsurf, VS Code, Claude Code, Continue.dev, **Cline & Zed**
49
+ 4. Writes the correct MCP config for every detected editor
50
+ 5. Creates `CLAUDE.md` with memory rules pre-filled
51
+ 6. Shows your Brain Health snapshot right in the terminal
52
+
53
+ **Index your project** into the Brain for instant semantic search:
54
+ ```bash
55
+ npx @cachly-dev/mcp-server@latest index .
56
+ ```
57
+
58
+ **Result:** Your AI remembers everything. Always.
38
59
 
39
60
  ---
40
61
 
41
- ## What it looks like
62
+ ## Quick Start (Manual)
42
63
 
43
- Every session starts with this instead of a blank slate:
64
+ **Step 1 — Get your free credentials** at [cachly.dev](https://cachly.dev) (25 MB free, forever, no credit card).
44
65
 
45
- ```
46
- 🧠 Session Briefing
66
+ **Step 2 — Add to your editor's MCP config:**
47
67
 
48
- 📅 Last session (2h ago): Fixed auth redirect loop in Next.js middleware
49
- Duration: 47 min · Files: middleware.ts, auth.config.ts, .env.local
68
+ <details>
69
+ <summary><b>Claude Code</b> (<code>~/.claude/mcp.json</code> or <code>.mcp.json</code>)</summary>
50
70
 
51
- 📊 Brain: 23 lessons · 5 context entries · 38 recalls · ~9.5h saved
71
+ ```json
72
+ {
73
+ "mcpServers": {
74
+ "cachly": {
75
+ "type": "stdio",
76
+ "command": "npx",
77
+ "args": ["-y", "@cachly-dev/mcp-server@latest"],
78
+ "env": {
79
+ "CACHLY_JWT": "your-jwt-token",
80
+ "CACHLY_INSTANCE_ID": "your-instance-id"
81
+ }
82
+ }
83
+ }
84
+ }
85
+ ```
86
+ </details>
52
87
 
53
- 🎯 Relevant for "auth":
54
- ✅ next:middleware-auth — matcher must exclude /_next/static paths (negative lookahead)
55
- ✅ keycloak:refresh-token — use httpOnly cookie, not localStorage — Safari blocks third-party
56
- ❌ oauth:pkce — PKCE + CORS broken in Safari 16.3, still unresolved
88
+ <details>
89
+ <summary><b>Cursor / Windsurf / VS Code</b> (<code>.cursor/mcp.json</code> / <code>.mcp.json</code>)</summary>
57
90
 
58
- 🕐 Recent lessons:
59
- ✅ redis:pipeline-batching — pipeline() for N writes, 10× faster than sequential
60
- ✅ deploy:healthcheck — readinessProbe.failureThreshold must be ≥ 10 on cold starts
61
- ✅ typescript:strictNullChecks — enable in tsconfig, catches 30% of runtime errors at compile time
91
+ ```json
92
+ {
93
+ "servers": {
94
+ "cachly": {
95
+ "type": "stdio",
96
+ "command": "npx",
97
+ "args": ["-y", "@cachly-dev/mcp-server@latest"],
98
+ "env": {
99
+ "CACHLY_JWT": "your-jwt-token",
100
+ "CACHLY_INSTANCE_ID": "your-instance-id"
101
+ }
102
+ }
103
+ }
104
+ }
62
105
  ```
106
+ </details>
63
107
 
64
- Your AI arrives pre-briefed. No repeating yourself. No re-explaining the architecture.
65
- Just: **"session_start" → full context → work.**
108
+ **Step 3 — Add to `CLAUDE.md` / `.github/copilot-instructions.md`:**
109
+
110
+ ```markdown
111
+ ## AI Brain Rules (cachly)
112
+ - Call session_start BEFORE reading any files or making changes
113
+ - Call learn_from_attempts AFTER every fix, deploy, or discovery
114
+ - Call session_end when closing the window
115
+ ```
66
116
 
67
117
  ---
68
118
 
69
- ## Before vs. After
119
+ ## With vs. Without cachly
70
120
 
71
121
  | Situation | Without cachly | With cachly |
72
122
  |-----------|----------------|-------------|
73
- | Session start | "What's your architecture?" | Briefed in 2s — lessons, last session, open failures |
74
- | Bug hits again | Re-researches from scratch (20–40 min) | "You fixed this on March 12, exact command: `kubectl rollout restart`" |
75
- | After holiday | Context completely dead | Full context restored, team lessons visible |
76
- | New team member | Weeks to onboard | `session_start` gives full codebase context instantly |
77
- | Repeated patterns | Pays tokens for each re-discovery | Recalled in 1 round-trip, ~1,200 tokens saved per hit |
123
+ | Session start | "What's your architecture?" | "Ready. 23 lessons, last session: deployed API." |
124
+ | Known bug hits again | Re-researches from scratch | "You fixed this on March 12, here's the exact command" |
125
+ | After holiday / team handoff | Context dead | Fully briefed in < 10 seconds |
126
+ | Repeated LLM patterns | Pays for each re-discovery | Cached by meaning, ~1,200 tokens saved per hit |
127
+ | New team member | Weeks to onboard | `session_start` gives full context instantly |
78
128
 
79
129
  ---
80
130
 
81
- ## Setup Wizard — What Happens
82
-
83
- ```
84
- 🧠 cachly AI Brain — Interactive Setup
85
- ────────────────────────────────────────
86
-
87
- Step 1: Sign in to cachly (free — no credit card required)
88
- Code: XKCD-9281
89
- URL: https://auth.cachly.dev/activate?user_code=XKCD-9281
90
- ✓ Browser opened — confirm the code above to continue...
91
- ................. ✓ Authorized!
92
- ⏳ Generating your API key... ✓
131
+ ## 51 MCP Tools
93
132
 
94
- ⏳ Fetching your instances... found 1
133
+ ### 🧠 Session & Memory (most used)
95
134
 
96
- ✓ Instance: My Brain (a1b2c3d4…)
135
+ | Tool | What it does |
136
+ |------|-------------|
137
+ | **`session_start`** | Full briefing: last session summary, open failures, recent lessons, brain health |
138
+ | **`session_end`** | Save what you built, auto-extract lessons from summary + ambient git log |
139
+ | **`session_handoff`** | Hand off remaining tasks to next window, with context |
140
+ | **`auto_learn_session`** | Batch-learn from a list of observations |
141
+ | **`sync_file_changes`** | Sync changed files into brain index |
142
+ | **`learn_from_attempts`** | Store structured lessons after any fix, deploy, or discovery |
143
+ | **`recall_best_solution`** | Best known solution for a topic — with success/failure history |
144
+ | **`recall_at`** | Recall a lesson at a specific point in time |
145
+ | **`remember_context`** | Cache architecture findings, decisions, file summaries |
146
+ | **`recall_context`** | Get exact context by key (supports glob) |
147
+ | **`list_remembered`** | See all cached context entries |
148
+ | **`forget_context`** | Remove stale context |
149
+ | **`smart_recall`** | BM25+ full-text search across all brain data — multilingual: EN, DE, FR, ES, IT, PT, ZH, JA, KO, **AR, HE** |
150
+ | **`setup_ai_memory`** | Interactive wizard to configure AI memory |
151
+
152
+ ### 🌍 Multilingual Brain — Search in Any Language
153
+
154
+ The Brain's search engine understands **11 languages natively** — no configuration required.
155
+
156
+ | Script | Languages | Tokenization |
157
+ |--------|-----------|-------------|
158
+ | Latin | EN, DE, FR, ES, IT, PT | Whitespace + stopwords |
159
+ | CJK | Chinese (ZH), Japanese (JA), Korean (KO) | Character bigrams |
160
+ | RTL | Arabic (AR), Hebrew (HE) | Word tokenization + light stemming |
161
+
162
+ **Romanization matching** — store lessons in Japanese, search in romaji:
163
+ ```
164
+ smart_recall("kontena") → finds コンテナ docs
165
+ smart_recall("depuroi") → finds デプロイ docs
166
+ ```
97
167
 
98
- Step 3: Detected editors: Claude Code, Cursor, GitHub Copilot
99
- Configure for which? [all / claude/cursor/copilot] (Enter = all):
168
+ **Cross-language retrieval** — 130+ tech term synonyms EN↔JA↔ZH↔KO↔AR↔HE:
169
+ ```
170
+ smart_recall("deploy") → finds デプロイ, 部署, 배포, نشر, פריסה
171
+ smart_recall("デプロイ") → finds "deploy", "deployment"
172
+ smart_recall("خطأ") → finds "error", エラー, 错误
173
+ ```
100
174
 
101
- ✅ Written: .mcp.json
102
- ✅ Written: .cursor/mcp.json
103
- ✅ Written: CLAUDE.md
175
+ ### 💡 Legendary Brain Features
104
176
 
105
- 🧠 Done! Restart your editor — the `cachly` MCP tools will appear.
106
- Your AI now has persistent memory across every session.
107
- ```
177
+ | Feature | How it works |
178
+ |---------|-------------|
179
+ | **Team Telepathy** | Multi-dev Brain: the `author` param on `learn_from_attempts` shares fixes across the whole team. Every `session_start` shows colleagues' lessons. |
180
+ | **Ambient Git Learning** | Pass `workspace_path` to `session_end` — it auto-reads `git log`, stores recent commits as Brain lessons. Zero extra calls. |
181
+ | **Memory Crystals** | `memory_crystalize` distills all lessons into a compact Crystal injected at every `session_start`. AI arrives pre-loaded with team knowledge. |
182
+ | **IQ Boost** | `brain_doctor` reports `iq_boost_pct` — how much smarter your AI gets vs. baseline from cached lessons. |
108
183
 
109
- ---
184
+ ### ⚙️ Instance Management
110
185
 
111
- ## Tools (most important ones)
186
+ | Tool | What it does |
187
+ |------|-------------|
188
+ | `list_instances` | List all your cache instances |
189
+ | `create_instance` | Spin up a new instance (free or paid) |
190
+ | `get_connection_string` | Get the `redis://` URL for your app |
191
+ | `delete_instance` | Remove an instance |
192
+ | `get_real_time_stats` | Memory, hit rate, ops/sec |
112
193
 
113
- ### Session & Memory
194
+ ### 🗄️ Cache Operations
114
195
 
115
196
  | Tool | What it does |
116
197
  |------|-------------|
117
- | **`session_start`** | Full briefing: last session, open failures, relevant lessons, brain stats |
118
- | **`session_end`** | Save what you built, auto-extract lessons from summary + git log |
119
- | **`learn_from_attempts`** | Store lessons after any fix, deploy, or discovery |
120
- | **`recall_best_solution`** | Best known fix for a topic — with full success/failure history |
121
- | **`smart_recall`** | Full-text search across all brain data (BM25+) |
122
- | **`remember_context`** / **`recall_context`** | Save/restore architecture findings, file summaries, ADRs |
123
- | **`forget_lesson`** | Remove a stale or wrong lesson |
124
- | **`list_lessons`** | Overview of all stored topics with severity, age, recall count |
198
+ | `cache_get` / `cache_set` / `cache_delete` | Standard cache operations |
199
+ | `cache_mget` / `cache_mset` | Bulk pipeline (single round-trip) |
200
+ | `cache_lock_acquire` / `cache_lock_release` | Distributed Redlock-lite |
201
+ | `cache_stream_set` / `cache_stream_get` | LLM token stream caching |
125
202
 
126
- ### Team Brain
203
+ ### 🔍 Semantic Cache
127
204
 
128
205
  | Tool | What it does |
129
206
  |------|-------------|
130
- | **`team_learn`** / **`team_recall`** | Share lessons across the whole team on a shared instance |
131
- | **`memory_crystalize`** | Distill all lessons into a Crystal snapshot — injected at every `session_start` |
132
- | **`brain_doctor`** | Health check: IQ boost %, lesson quality, open failures |
133
- | **`invite_member`** | Invite a dev to your org by email |
207
+ | `semantic_search` | Find cached entries by meaning (pgvector HNSW, EU-hosted) |
208
+ | `semantic_warmup` | Pre-warm cache with prompt/response pairs |
209
+ | `detect_namespace` | Auto-classify prompt into code/qa/summary/translation/creative |
134
210
 
135
- ### Cache & Infrastructure
211
+ ### 👥 Team Brain
136
212
 
137
213
  | Tool | What it does |
138
214
  |------|-------------|
139
- | `cache_get` / `cache_set` / `cache_delete` | Standard Redis operations |
140
- | `cache_mget` / `cache_mset` | Bulk pipeline (single round-trip) |
141
- | `semantic_search` | Find cached entries by meaning (vector search, EU-hosted) |
142
- | `get_connection_string` | Get the `redis://` URL for your own app |
215
+ | `team_learn` / `team_recall` | Share lessons across the team |
216
+ | `team_synthesize` | Consolidate multiple lessons into one authoritative version |
217
+ | `memory_crystalize` | Distill all lessons into a Crystal snapshot for instant team context |
218
+ | `brain_doctor` | Health check: lesson count, IQ boost %, open failures, quality score |
219
+ | `global_learn` / `global_recall` | Cross-project universal lessons |
220
+ | `publish_lesson` / `import_public_brain` | Share/import community knowledge |
221
+ | `trace_dependency` | Causal chain — find lessons affected by a dependency change |
222
+ | `list_orgs` / `create_org` | Manage team organizations |
223
+ | `invite_member` / `get_org_plan` | Invite a developer to your org by email |
143
224
 
144
225
  ---
145
226
 
@@ -147,69 +228,13 @@ Step 3: Detected editors: Claude Code, Cursor, GitHub Copilot
147
228
 
148
229
  | Tier | RAM | Price | Best for |
149
230
  |------|-----|-------|----------|
150
- | **Free** | 25 MB | **€0/mo forever** | Side projects & solo devs |
231
+ | **Free** | 25 MB | **€0/mo forever** | Dev & side projects |
151
232
  | **Dev** | 200 MB | €19/mo | Individual developers |
152
- | **Pro** | 900 MB | €49/mo | Teams (shared brain) |
153
- | **Speed** | 900 MB + Dragonfly + Semantic | €79/mo | AI-heavy workloads |
233
+ | **Pro** | 900 MB | €49/mo | Teams |
234
+ | **Speed** | 900 MB + Dragonfly + Semantic Cache | €79/mo | AI-heavy workloads |
154
235
  | **Business** | 7 GB | €199/mo | Scale-ups |
155
236
 
156
- ✅ All plans: **German servers · GDPR-compliant · 99.9% SLA · no credit card for Free**
157
-
158
- ---
159
-
160
- ## Manual setup (if you prefer)
161
-
162
- <details>
163
- <summary>Claude Code (<code>~/.claude/mcp.json</code> or <code>.mcp.json</code>)</summary>
164
-
165
- ```json
166
- {
167
- "mcpServers": {
168
- "cachly": {
169
- "type": "stdio",
170
- "command": "npx",
171
- "args": ["-y", "@cachly-dev/mcp-server@latest"],
172
- "env": {
173
- "CACHLY_JWT": "your-api-key",
174
- "CACHLY_BRAIN_INSTANCE_ID": "your-instance-id"
175
- }
176
- }
177
- }
178
- }
179
- ```
180
- </details>
181
-
182
- <details>
183
- <summary>Cursor / Windsurf (<code>.cursor/mcp.json</code> or <code>.mcp.json</code>)</summary>
184
-
185
- ```json
186
- {
187
- "servers": {
188
- "cachly": {
189
- "type": "stdio",
190
- "command": "npx",
191
- "args": ["-y", "@cachly-dev/mcp-server@latest"],
192
- "env": {
193
- "CACHLY_JWT": "your-api-key",
194
- "CACHLY_BRAIN_INSTANCE_ID": "your-instance-id"
195
- }
196
- }
197
- }
198
- }
199
- ```
200
- </details>
201
-
202
- <details>
203
- <summary>CLAUDE.md brain rules</summary>
204
-
205
- ```markdown
206
- ## AI Brain (cachly)
207
- - ALWAYS call `session_start` at the beginning of every session — no exceptions
208
- - After every fix, deploy, or discovery: call `learn_from_attempts`
209
- - Before working on a known topic: call `recall_best_solution("<topic>")`
210
- - At session end: call `session_end` with a one-line summary
211
- ```
212
- </details>
237
+ ✅ All plans: **German servers · GDPR-compliant · 99.9% SLA · No credit card for Free tier**
213
238
 
214
239
  ---
215
240
 
@@ -217,27 +242,30 @@ Step 3: Detected editors: Claude Code, Cursor, GitHub Copilot
217
242
 
218
243
  | Variable | Default | Description |
219
244
  |----------|---------|-------------|
220
- | `CACHLY_JWT` | — | **Required.** API key or JWT from the setup wizard |
221
- | `CACHLY_BRAIN_INSTANCE_ID` | — | Default instance UUID — set once, works in all tools |
245
+ | `CACHLY_JWT` | — | **Required.** Your API token from [cachly.dev](https://cachly.dev) |
246
+ | `CACHLY_INSTANCE_ID` | — | Default instance UUID (optional if you pass per-call) |
222
247
  | `CACHLY_API_URL` | `https://api.cachly.dev` | Override for self-hosted |
223
- | `CACHLY_NO_TELEMETRY` | unset | Set to `1` to opt out of anonymous usage pings |
248
+ | `CACHLY_NO_TELEMETRY` | unset | Set to `1` to disable anonymous usage pings |
249
+ | `CACHLY_NO_UPDATE_CHECK` | unset | Set to `1` to disable the version-check on startup |
224
250
 
225
251
  ---
226
252
 
227
- ## Ecosystem
253
+ ## 🛠️ Ecosystem
228
254
 
229
255
  | Package | What it does |
230
256
  |---------|-------------|
231
- | **[`@cachly-dev/mcp-server`](https://www.npmjs.com/package/@cachly-dev/mcp-server)** | ← you are here — AI Brain MCP for Claude Code, Cursor, Copilot, Windsurf |
232
- | **[`cachly-brain` (VS Code)](https://marketplace.visualstudio.com/items?itemName=cachly.cachly-brain)** | VS Code extension — status bar, CodeLens lessons, one-click setup |
233
- | **[`@cachly-dev/openclaw`](https://www.npmjs.com/package/@cachly-dev/openclaw)** | JS/TS SDK — cut LLM costs 60–90% with semantic cache in your own app |
234
- | **[`@cachly-dev/sdk`](https://www.npmjs.com/package/@cachly-dev/sdk)** | Node.js SDK — managed Redis, semantic cache & AI memory in your app |
257
+ | **[`@cachly-dev/mcp-server`](https://www.npmjs.com/package/@cachly-dev/mcp-server)** | ← you are here — AI Brain MCP tools for Claude Code, Cursor, Copilot, Windsurf |
258
+ | **[`@cachly-dev/openclaw`](https://www.npmjs.com/package/@cachly-dev/openclaw)** | JS/TS SDK — cut LLM costs 60–90% with semantic cache + BM25 in your own app, 3 lines of code |
259
+ | **[`@cachly-dev/init`](https://www.npmjs.com/package/@cachly-dev/init)** | One-command setup wizard: auto-detects all your editors and writes the correct MCP config — `npx @cachly-dev/init` |
260
+ | **[`@cachly-dev/cli`](https://www.npmjs.com/package/@cachly-dev/cli)** | Terminal CLI — manage instances, cache data, brain lessons: `npm i -g @cachly-dev/cli` |
261
+ | **[`@cachly-dev/sdk`](https://www.npmjs.com/package/@cachly-dev/sdk)** | Node.js/TypeScript SDK — use managed Redis, semantic cache & AI memory directly in your app |
235
262
 
236
263
  ---
237
264
 
238
265
  ## Links
239
266
 
240
267
  - 🌐 [cachly.dev](https://cachly.dev) — Dashboard & free signup
241
- - 📖 [Docs](https://cachly.dev/docs/ai-memory) — Full documentation
242
- - 💬 [Issues](https://github.com/cachly-dev/cachly-mcp/issues) — Bug reports & feature requests
243
- - ⭐ [Star on GitHub](https://github.com/cachly-dev/cachly-mcp) — If cachly saves you time, a star means a lot
268
+ - 📖 [AI Brain docs](https://cachly.dev/docs/ai-memory) — Full documentation
269
+ - 💬 [GitHub Issues](https://github.com/cachly-dev/mcp-server/issues) — Bug reports & feature requests
270
+ - ⭐ [Star on GitHub](https://github.com/cachly-dev/mcp-server) — If cachly saves you time, a star means a lot!
271
+ - 📦 [npm](https://www.npmjs.com/package/@cachly-dev/mcp-server)
@@ -0,0 +1 @@
1
+ export {};