mnemos-capture 1.6.0 → 1.6.1
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 +26 -18
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
<br>
|
|
10
10
|
<br>
|
|
11
11
|
<p>
|
|
12
|
-
<a href="https://www.npmjs.com/package/
|
|
12
|
+
<a href="https://www.npmjs.com/package/@xmu-labs/xkg"><img src="https://img.shields.io/npm/v/@xmu-labs/xkg?color=1c74d8&labelColor=000820&style=flat" alt="npm" /></a>
|
|
13
13
|
<img src="https://img.shields.io/badge/MCP-compatible-9dd8f5?labelColor=000820&style=flat" alt="MCP" />
|
|
14
14
|
<img src="https://img.shields.io/badge/license-MIT-f0f4f8?labelColor=000820&style=flat" alt="MIT" />
|
|
15
15
|
</p>
|
|
@@ -53,7 +53,7 @@ You find useful stuff, you capture through the web app, then xkg connects it int
|
|
|
53
53
|
xkg will continuously compound that knowledge over time — keeping AI workers' context up to date as human knowledge evolves.
|
|
54
54
|
|
|
55
55
|
> [!IMPORTANT]
|
|
56
|
-
> We are migrating from **mnemos** / **Xmu** to **xkg**. The app now lives at [xkg.xmu.sh](https://xkg.xmu.sh) and the code at [xmu-labs/xkg](https://github.com/xmu-labs/xkg). Connectors set up with `mnemos-capture.vercel.app` keep working
|
|
56
|
+
> We are migrating from **mnemos** / **Xmu** to **xkg**. The app now lives at [xkg.xmu.sh](https://xkg.xmu.sh) and the code at [xmu-labs/xkg](https://github.com/xmu-labs/xkg). The npm package is now `@xmu-labs/xkg`. Connectors set up with `mnemos-capture.vercel.app` and commands that run `npx mnemos-capture@latest` keep working: every release is published under both names. Sorry for the inconvenience.
|
|
57
57
|
|
|
58
58
|
## Start here
|
|
59
59
|
|
|
@@ -95,7 +95,7 @@ https://xkg.xmu.sh/api/mcp
|
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
```bash
|
|
98
|
-
npx -y
|
|
98
|
+
npx -y @xmu-labs/xkg@latest serve-mcp --key YOUR_API_KEY
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
The CLI binary is **`xkg`** (also `xmu` and `mnemos-capture`). An MCP server already registered as `xmu` or `mnemos`, or set up with `mnemos-capture@latest`, keeps working.
|
|
@@ -126,7 +126,7 @@ Name the connector `xkg`, paste `https://xkg.xmu.sh/api/mcp`, sign in with GitHu
|
|
|
126
126
|
The same command works in every CLI — Cursor, Codex, Gemini CLI, VS Code, Claude Code, or anything that can launch a local MCP server:
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
npx -y
|
|
129
|
+
npx -y @xmu-labs/xkg@latest serve-mcp --key YOUR_API_KEY
|
|
130
130
|
```
|
|
131
131
|
|
|
132
132
|
Register that command in the tool you use.
|
|
@@ -140,7 +140,7 @@ Add this to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (all projects):
|
|
|
140
140
|
"mcpServers": {
|
|
141
141
|
"xkg": {
|
|
142
142
|
"command": "npx",
|
|
143
|
-
"args": ["-y", "
|
|
143
|
+
"args": ["-y", "@xmu-labs/xkg@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
|
|
144
144
|
}
|
|
145
145
|
}
|
|
146
146
|
}
|
|
@@ -157,7 +157,7 @@ Add this to `.vscode/mcp.json`:
|
|
|
157
157
|
"servers": {
|
|
158
158
|
"xkg": {
|
|
159
159
|
"command": "npx",
|
|
160
|
-
"args": ["-y", "
|
|
160
|
+
"args": ["-y", "@xmu-labs/xkg@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
|
|
161
161
|
}
|
|
162
162
|
}
|
|
163
163
|
}
|
|
@@ -172,7 +172,7 @@ Codex CLI — add this to `~/.codex/config.toml`:
|
|
|
172
172
|
```toml
|
|
173
173
|
[mcp_servers.xkg]
|
|
174
174
|
command = "npx"
|
|
175
|
-
args = ["-y", "
|
|
175
|
+
args = ["-y", "@xmu-labs/xkg@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
|
|
176
176
|
```
|
|
177
177
|
|
|
178
178
|
Codex App: Settings → MCP → add the same `npx` command.
|
|
@@ -180,13 +180,13 @@ Codex App: Settings → MCP → add the same `npx` command.
|
|
|
180
180
|
#### Gemini CLI
|
|
181
181
|
|
|
182
182
|
```bash
|
|
183
|
-
gemini mcp add xkg npx -y
|
|
183
|
+
gemini mcp add xkg npx -y @xmu-labs/xkg@latest serve-mcp --key YOUR_API_KEY
|
|
184
184
|
```
|
|
185
185
|
|
|
186
186
|
#### Claude Code
|
|
187
187
|
|
|
188
188
|
```bash
|
|
189
|
-
claude mcp add xkg -- npx -y
|
|
189
|
+
claude mcp add xkg -- npx -y @xmu-labs/xkg@latest serve-mcp --key YOUR_API_KEY
|
|
190
190
|
```
|
|
191
191
|
|
|
192
192
|
Or the URL, no API key:
|
|
@@ -198,7 +198,7 @@ claude mcp add --transport http xkg https://xkg.xmu.sh/api/mcp
|
|
|
198
198
|
Optional session hooks (MCP works without them):
|
|
199
199
|
|
|
200
200
|
```bash
|
|
201
|
-
npx -y
|
|
201
|
+
npx -y @xmu-labs/xkg@latest setup-hooks --key YOUR_API_KEY --briefing --vault
|
|
202
202
|
```
|
|
203
203
|
|
|
204
204
|
Hooks are local files — they run in the CLI and editor extensions, not in the browser.
|
|
@@ -212,7 +212,7 @@ Settings → Developer → Edit Config. Add the same `npx` block to `claude_desk
|
|
|
212
212
|
"mcpServers": {
|
|
213
213
|
"xkg": {
|
|
214
214
|
"command": "npx",
|
|
215
|
-
"args": ["-y", "
|
|
215
|
+
"args": ["-y", "@xmu-labs/xkg@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
|
|
216
216
|
}
|
|
217
217
|
}
|
|
218
218
|
}
|
|
@@ -227,7 +227,7 @@ If the tool can launch a local process, register the same `npx` command. If it h
|
|
|
227
227
|
"mcpServers": {
|
|
228
228
|
"xkg": {
|
|
229
229
|
"command": "npx",
|
|
230
|
-
"args": ["-y", "
|
|
230
|
+
"args": ["-y", "@xmu-labs/xkg@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
|
|
231
231
|
}
|
|
232
232
|
}
|
|
233
233
|
}
|
|
@@ -256,14 +256,14 @@ No MCP support yet? Capture in the [xkg app](https://xkg.xmu.sh) and connect lat
|
|
|
256
256
|
4. **Execute** — Hand the plan to your worker in the current session, or run it in an isolated git worktree:
|
|
257
257
|
|
|
258
258
|
```bash
|
|
259
|
-
npx -y
|
|
260
|
-
npx -y
|
|
259
|
+
npx -y @xmu-labs/xkg@latest config set agent "claude -p"
|
|
260
|
+
npx -y @xmu-labs/xkg@latest kos --key YOUR_API_KEY
|
|
261
261
|
```
|
|
262
262
|
|
|
263
263
|
`kos` creates a worktree, loads the plan as the contract, launches the assistant you configured, and prints the verification checklist when it finishes.
|
|
264
264
|
|
|
265
265
|
```bash
|
|
266
|
-
npx -y
|
|
266
|
+
npx -y @xmu-labs/xkg@latest config set agent "codex exec"
|
|
267
267
|
```
|
|
268
268
|
|
|
269
269
|
### Example capture
|
|
@@ -331,12 +331,12 @@ You don't have to memorize these. Ask in plain language: "save this", "what do I
|
|
|
331
331
|
No global install required. The binary is **`xkg`** (also `xmu` and `mnemos-capture`). Via npx:
|
|
332
332
|
|
|
333
333
|
```bash
|
|
334
|
-
npx -y
|
|
334
|
+
npx -y @xmu-labs/xkg@latest <command>
|
|
335
335
|
```
|
|
336
336
|
|
|
337
337
|
| Command | What it does |
|
|
338
338
|
| --- | --- |
|
|
339
|
-
| `npx -y
|
|
339
|
+
| `npx -y @xmu-labs/xkg@latest` | Open the hosted app |
|
|
340
340
|
| `serve-mcp --key YOUR_API_KEY` | Run the local MCP proxy |
|
|
341
341
|
| `setup-hooks --key YOUR_API_KEY [--briefing] [--vault]` | Install Claude Code hooks |
|
|
342
342
|
| `config set agent "claude -p"` | Set which assistant `kos` should drive |
|
|
@@ -345,6 +345,8 @@ npx -y mnemos-capture@latest <command>
|
|
|
345
345
|
| `vault-check --key YOUR_API_KEY` | Debug the vault hook |
|
|
346
346
|
| `help` | Show help |
|
|
347
347
|
|
|
348
|
+
What changed in each version: [GitHub Releases](https://github.com/xmu-labs/xkg/releases).
|
|
349
|
+
|
|
348
350
|
## Your context stays in GitHub
|
|
349
351
|
|
|
350
352
|
Captures live as structured Markdown in **your** GitHub repository. Private by default.
|
|
@@ -423,7 +425,13 @@ Working on the code? See [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
|
423
425
|
|
|
424
426
|
## License
|
|
425
427
|
|
|
426
|
-
[MIT License](./LICENSE)
|
|
428
|
+
[MIT License](./LICENSE). Contributions are welcome under the same licence; see
|
|
429
|
+
[CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md).
|
|
430
|
+
|
|
431
|
+
**Trademarks.** The MIT licence covers the code, not names or logos: the xkg name and logo are not
|
|
432
|
+
licensed for use as your own brand. Claude, ChatGPT, Codex, Gemini, Grok, Cursor and VS Code are
|
|
433
|
+
trademarks of their respective owners, named here only to say which tools xkg works with; no
|
|
434
|
+
endorsement is implied.
|
|
427
435
|
|
|
428
436
|
If you use xkg in published work:
|
|
429
437
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mnemos-capture",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.1",
|
|
4
4
|
"description": "xkg — Turn what you discover into context your AI workers can use. Capture once, then brief, plan, and execute with any MCP-compatible tool.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -40,7 +40,10 @@
|
|
|
40
40
|
"type": "git",
|
|
41
41
|
"url": "git+https://github.com/xmu-labs/xkg.git"
|
|
42
42
|
},
|
|
43
|
-
"homepage": "https://
|
|
43
|
+
"homepage": "https://xkg.xmu.sh",
|
|
44
|
+
"bugs": {
|
|
45
|
+
"url": "https://github.com/xmu-labs/xkg/issues"
|
|
46
|
+
},
|
|
44
47
|
"files": [
|
|
45
48
|
"dist/cli/",
|
|
46
49
|
"LICENSE",
|