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.
Files changed (2) hide show
  1. package/README.md +26 -18
  2. 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/mnemos-capture"><img src="https://img.shields.io/npm/v/mnemos-capture?color=1c74d8&labelColor=000820&style=flat" alt="npm" /></a>
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. The npm package still says `mnemos-capture`. Sorry for the inconvenience.
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 mnemos-capture@latest serve-mcp --key YOUR_API_KEY
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 mnemos-capture@latest serve-mcp --key YOUR_API_KEY
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", "mnemos-capture@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
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", "mnemos-capture@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
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", "mnemos-capture@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
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 mnemos-capture@latest serve-mcp --key YOUR_API_KEY
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 mnemos-capture@latest serve-mcp --key YOUR_API_KEY
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 mnemos-capture@latest setup-hooks --key YOUR_API_KEY --briefing --vault
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", "mnemos-capture@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
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", "mnemos-capture@latest", "serve-mcp", "--key", "YOUR_API_KEY"]
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 mnemos-capture@latest config set agent "claude -p"
260
- npx -y mnemos-capture@latest kos --key YOUR_API_KEY
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 mnemos-capture@latest config set agent "codex exec"
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 mnemos-capture@latest <command>
334
+ npx -y @xmu-labs/xkg@latest <command>
335
335
  ```
336
336
 
337
337
  | Command | What it does |
338
338
  | --- | --- |
339
- | `npx -y mnemos-capture@latest` | Open the hosted app |
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.0",
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://github.com/xmu-labs/xkg",
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",