wenlan-mcp 0.9.6 → 0.10.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 +19 -18
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -62,10 +62,10 @@ Unlike a static llm-wiki, it keeps evolving between sessions. Unlike a black-box
|
|
|
62
62
|
```text
|
|
63
63
|
/plugin marketplace add 7xuanlu/claude-plugins
|
|
64
64
|
/plugin install wenlan@7xuanlu
|
|
65
|
-
/
|
|
65
|
+
/setup
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
If Claude Code asks for a restart after installing, restart once, then run `/
|
|
68
|
+
If Claude Code asks for a restart after installing, restart once, then run `/setup`. The plugin handles local runtime setup, MCP wiring, local memory setup, and the first round-trip check.
|
|
69
69
|
|
|
70
70
|
Then try `/brief`, `/capture <decision>`, or `/handoff` inside Claude Code.
|
|
71
71
|
|
|
@@ -73,7 +73,7 @@ Plugin details and daily commands: [plugin/](plugin/.claude-plugin/README.md).
|
|
|
73
73
|
|
|
74
74
|
### Codex plugin (local development)
|
|
75
75
|
|
|
76
|
-
The Codex plugin lives in [plugin-codex](plugin-codex/) and is exposed through the repo-local marketplace at [.agents/plugins/marketplace.json](.agents/plugins/marketplace.json). It adds `/
|
|
76
|
+
The Codex plugin lives in [plugin-codex](plugin-codex/) and is exposed through the repo-local marketplace at [.agents/plugins/marketplace.json](.agents/plugins/marketplace.json). It adds `/setup`, `/brief`, `/capture`, `/recall`, `/distill`, `/pages`, `/curate`, `/forget`, `/handoff`, and `/help` skills plus a `wenlan` MCP server.
|
|
77
77
|
|
|
78
78
|
From this repo:
|
|
79
79
|
|
|
@@ -83,7 +83,7 @@ codex plugin marketplace add .
|
|
|
83
83
|
codex plugin add wenlan@wenlan-local
|
|
84
84
|
```
|
|
85
85
|
|
|
86
|
-
Start a new Codex thread after installing so the skills and MCP server load. Then try `/
|
|
86
|
+
Start a new Codex thread after installing so the skills and MCP server load. Then try `/setup`, `/brief`, `/capture <memory>`, `/recall <query>`, `/pages <query>`, or `/handoff`.
|
|
87
87
|
|
|
88
88
|
For plugin development, reinstall after plugin edits:
|
|
89
89
|
|
|
@@ -92,7 +92,7 @@ python3 ~/.codex/skills/.system/plugin-creator/scripts/update_plugin_cachebuster
|
|
|
92
92
|
codex plugin add wenlan@wenlan-local
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
The plugin runner uses `~/.wenlan/bin/wenlan-mcp` when available and falls back to `npx -y wenlan-mcp@^0.
|
|
95
|
+
The plugin runner uses `~/.wenlan/bin/wenlan-mcp` when available and falls back to `npx -y wenlan-mcp@^0.10.0`. It passes `--agent-name codex` so captures are labeled as Codex writes.
|
|
96
96
|
|
|
97
97
|
The shared Claude/Codex plugin inventory lives in [plugin-contract.json](plugin-contract.json). Before changing plugin skills, manifests, MCP runner wiring, or the local marketplace, run:
|
|
98
98
|
|
|
@@ -108,10 +108,10 @@ Use this if you want Wenlan tools in Claude Code without the plugin, or in Codex
|
|
|
108
108
|
|
|
109
109
|
```bash
|
|
110
110
|
npx -y wenlan setup
|
|
111
|
-
~/.wenlan/bin/wenlan
|
|
111
|
+
~/.wenlan/bin/wenlan connect claude-code # or: codex, cursor, claude-desktop, vscode, gemini
|
|
112
112
|
```
|
|
113
113
|
|
|
114
|
-
MCP-only gives agents tools for capture, recall, context, doctor, and page distillation. It does not install
|
|
114
|
+
MCP-only gives agents tools for capture, recall, context, doctor, and page distillation. It does not install plugin slash skills like `/brief`, `/handoff`, `/distill`, or `/setup`.
|
|
115
115
|
|
|
116
116
|
### Terminal runtime setup
|
|
117
117
|
|
|
@@ -121,18 +121,18 @@ Set up the local Wenlan runtime:
|
|
|
121
121
|
npx -y wenlan setup
|
|
122
122
|
```
|
|
123
123
|
|
|
124
|
-
Then start with `~/.wenlan/bin/wenlan status`, `~/.wenlan/bin/wenlan recall <query>`, or `~/.wenlan/bin/wenlan
|
|
124
|
+
Then start with `~/.wenlan/bin/wenlan status`, `~/.wenlan/bin/wenlan recall <query>`, or `~/.wenlan/bin/wenlan capture <text>`. CLI details: [crates/wenlan-cli](crates/wenlan-cli/README.md).
|
|
125
125
|
|
|
126
126
|
Service management:
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
wenlan
|
|
130
|
-
wenlan restart # stop + start the
|
|
129
|
+
wenlan background on # register + start the background runtime
|
|
130
|
+
wenlan restart # stop + start the background runtime after upgrading
|
|
131
131
|
wenlan status
|
|
132
|
-
wenlan
|
|
132
|
+
wenlan background off
|
|
133
133
|
```
|
|
134
134
|
|
|
135
|
-
After upgrading Wenlan (`npx -y wenlan setup` or `install.sh`), the new binary is on disk but the already-running
|
|
135
|
+
After upgrading Wenlan (`npx -y wenlan setup` or `install.sh`), the new binary is on disk but the already-running runtime keeps serving the old code until you restart it. `wenlan background on` restarts automatically; if you upgraded another way, run `wenlan restart`.
|
|
136
136
|
|
|
137
137
|
---
|
|
138
138
|
|
|
@@ -163,7 +163,7 @@ These five verbs drive it:
|
|
|
163
163
|
2. **During work.** `/capture <thing>` saves a decision, lesson, gotcha, or project fact in flow. `/recall <query>` looks anything up.
|
|
164
164
|
3. **Session ends.** `/handoff` writes what changed, what's still open, and where to continue, so the next run picks up cleanly.
|
|
165
165
|
4. **Between sessions.** The daemon deduplicates overlapping captures and links related ideas in the background. `/distill` synthesizes wiki pages from clusters of related memories when you want a deliberate pass.
|
|
166
|
-
5. **Next session.** `/brief` brings it back in the Claude Code
|
|
166
|
+
5. **Next session.** `/brief` brings it back in the Claude Code and Codex plugins; MCP-only clients call the `context` tool for the same memory. Recall pulls the relevant slice, not your whole history, so the context window goes to the work.
|
|
167
167
|
|
|
168
168
|
Full skill reference: [plugin/skills](plugin/skills/README.md).
|
|
169
169
|
|
|
@@ -193,10 +193,10 @@ Memories belong to a **space** like `wenlan`, `career`, or
|
|
|
193
193
|
Or declaratively via `~/.wenlan/spaces.toml` (see
|
|
194
194
|
`plugin/examples/spaces.toml`). To manage spaces from the CLI:
|
|
195
195
|
|
|
196
|
-
wenlan
|
|
197
|
-
wenlan
|
|
198
|
-
wenlan
|
|
199
|
-
wenlan
|
|
196
|
+
wenlan spaces list
|
|
197
|
+
wenlan spaces add ideas --default
|
|
198
|
+
wenlan spaces show ideas
|
|
199
|
+
wenlan spaces move scratch career
|
|
200
200
|
|
|
201
201
|
`wenlan doctor` prints the current resolver state so you can see exactly
|
|
202
202
|
which layer chose the active space.
|
|
@@ -231,6 +231,7 @@ Wenlan is daemon-first. `wenlan-server` owns the local database, embeddings, dis
|
|
|
231
231
|
| [crates/wenlan-mcp](crates/wenlan-mcp/README.md) | MCP server, tools, npm package. |
|
|
232
232
|
| [crates/wenlan-cli](crates/wenlan-cli/README.md) | User CLI for setup, service management, search, recall, store, list, agents, model/key setup, and doctor. |
|
|
233
233
|
| [plugin/](plugin/.claude-plugin/README.md) | Claude Code plugin (`plugin.json`, skills, hooks, `.mcp.json`). |
|
|
234
|
+
| [plugin-codex/](plugin-codex/) | Codex plugin (`.codex-plugin/plugin.json`, skills, `agents/openai.yaml`, `.mcp.json`). |
|
|
234
235
|
| [docs/eval](docs/eval/README.md) | Benchmark workflow and methodology. |
|
|
235
236
|
|
|
236
237
|
|
|
@@ -293,7 +294,7 @@ Bug fixes, eval cases, docs, and features are welcome. Start with [CONTRIBUTING.
|
|
|
293
294
|
|
|
294
295
|
## License
|
|
295
296
|
|
|
296
|
-
Wenlan is licensed under **Apache-2.0**. This includes the local runtime, CLI, MCP server, shared types, and Claude Code plugin files in this repo.
|
|
297
|
+
Wenlan is licensed under **Apache-2.0**. This includes the local runtime, CLI, MCP server, shared types, and Claude Code/Codex plugin files in this repo.
|
|
297
298
|
|
|
298
299
|
The permissive license keeps the daemon boundary usable for MCP clients and downstream local tools.
|
|
299
300
|
|