mindweave 2.5.0 → 2.5.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 +145 -145
- package/dist/cli/App.js +1 -1
- package/dist/cli/App.js.map +1 -1
- package/dist/core/turnRunner.js +366 -0
- package/dist/core/turnRunner.js.map +1 -0
- package/dist/drivers/anthropic/client.js +77 -21
- package/dist/drivers/anthropic/client.js.map +1 -1
- package/dist/drivers/anthropic/manifest.js +28 -11
- package/dist/drivers/anthropic/manifest.js.map +1 -1
- package/dist/drivers/cerebras/manifest.js +7 -1
- package/dist/drivers/cerebras/manifest.js.map +1 -1
- package/dist/drivers/deepseek/manifest.js +12 -31
- package/dist/drivers/deepseek/manifest.js.map +1 -1
- package/dist/drivers/glm/manifest.js +18 -5
- package/dist/drivers/glm/manifest.js.map +1 -1
- package/dist/drivers/kimi/manifest.js +13 -10
- package/dist/drivers/kimi/manifest.js.map +1 -1
- package/dist/drivers/meta/manifest.js +21 -16
- package/dist/drivers/meta/manifest.js.map +1 -1
- package/dist/drivers/minimax/manifest.js +15 -12
- package/dist/drivers/minimax/manifest.js.map +1 -1
- package/dist/drivers/openai/manifest.js +24 -7
- package/dist/drivers/openai/manifest.js.map +1 -1
- package/dist/drivers/qwen/manifest.js +19 -6
- package/dist/drivers/qwen/manifest.js.map +1 -1
- package/dist/drivers/xai/client.js +12 -10
- package/dist/drivers/xai/client.js.map +1 -1
- package/dist/drivers/xai/manifest.js +62 -25
- package/dist/drivers/xai/manifest.js.map +1 -1
- package/dist/dynamo/engine.js +27 -0
- package/dist/dynamo/engine.js.map +1 -1
- package/dist/memory/compaction.js +1 -1
- package/dist/memory/compaction.js.map +1 -1
- package/dist/tools/detail.js +9 -6
- package/dist/tools/detail.js.map +1 -1
- package/dist/tools/edit.js +2 -1
- package/dist/tools/edit.js.map +1 -1
- package/dist/tools/replaceSymbol.js +2 -1
- package/dist/tools/replaceSymbol.js.map +1 -1
- package/dist/tools/runCommand.js +6 -3
- package/dist/tools/runCommand.js.map +1 -1
- package/dist/tools/writeFile.js +2 -1
- package/dist/tools/writeFile.js.map +1 -1
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -1,145 +1,145 @@
|
|
|
1
|
-
<h1 align="center">Mindweave (mwcode)</h1>
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
A fast, model-adaptive, terminal-native AI coding agent.<br>
|
|
5
|
-
You bring your own key. It runs on your machine. Nothing goes anywhere else.
|
|
6
|
-
</p>
|
|
7
|
-
|
|
8
|
-
<p align="center">
|
|
9
|
-
<a href="LICENSE">Apache 2.0</a> •
|
|
10
|
-
<a href="https://x.com/mindweavecli">X</a> •
|
|
11
|
-
<a href="https://mindweavedev.netlify.app/">Website</a>
|
|
12
|
-
</p>
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## What it is
|
|
17
|
-
|
|
18
|
-
Mindweave is a coding agent that lives in your terminal and works inside your repository:
|
|
19
|
-
reading, searching, editing, running commands, and checking its own work.
|
|
20
|
-
|
|
21
|
-
It runs entirely on your machine. There is no backend, no telemetry and no account. Your
|
|
22
|
-
code and your API key never reach a Mindweave server, because there isn't one.
|
|
23
|
-
|
|
24
|
-
It is built lean on purpose. Most of a coding agent's context budget goes on scaffolding
|
|
25
|
-
the model never needed. Mindweave keeps prompts thin and leaves the room for the model to
|
|
26
|
-
reason about your code.
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
## Mindweave 1
|
|
30
|
-
|
|
31
|
-
Mindweave 1 is out, tagged `mindweave-1`. It is on npm, and the website is up. Install
|
|
32
|
-
with the steps below.
|
|
33
|
-
|
|
34
|
-
What landed in it is in the [changelog](CHANGELOG.md): fourteen model providers, a
|
|
35
|
-
rebuilt terminal interface, reworked prompt caching and token accounting, project notes
|
|
36
|
-
the agent maintains across sessions, and a long list of things that were quietly wrong.
|
|
37
|
-
|
|
38
|
-
## Install
|
|
39
|
-
|
|
40
|
-
Requires **Windows** and **Node.js 20+**. macOS and Linux are not supported yet, and the
|
|
41
|
-
reason is written down in [KNOWN-ISSUES.md](KNOWN-ISSUES.md) rather than glossed over.
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
npm install -g mindweave
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
Then, in any project:
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
cd your-project
|
|
51
|
-
mindweave # or mw, for short
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
To build from source instead — for development, or to run an unreleased change:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
git clone https://github.com/mindweave-cli/Mindweave
|
|
58
|
-
cd Mindweave
|
|
59
|
-
npm install
|
|
60
|
-
npm run build
|
|
61
|
-
npm link # makes the `mindweave` command available globally
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
It asks for an API key on first launch and saves it to `~/.mindweave/.env`, so every
|
|
65
|
-
project afterwards just works. `mindweave --help` covers the launch flags; everything
|
|
66
|
-
else is configured inside a session.
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
## What it can do
|
|
70
|
-
|
|
71
|
-
Short version, one line each. The depth is in the linked pages.
|
|
72
|
-
|
|
73
|
-
- **15 providers,
|
|
74
|
-
Mistral, Groq, Cerebras, Qwen, Kimi, GLM, Meta, MiniMax, Tencent, plus every
|
|
75
|
-
tool-capable model on OpenRouter. Only the driver you
|
|
76
|
-
use is loaded. Switch with `/provider` and `/model`; remembered per project.
|
|
77
|
-
[PROVIDERS.md](src/drivers/PROVIDERS.md)
|
|
78
|
-
- **Real tools** — read and edit files, multi-file edits, ripgrep search, a shell with
|
|
79
|
-
background jobs, and sub-agents. Every edit comes back with the language server's own
|
|
80
|
-
errors for that file. Read-before-edit is enforced, and `/undo` is a real net.
|
|
81
|
-
- **Deterministic code intelligence** — a background lane indexes your repo with
|
|
82
|
-
tree-sitter and language servers, costing no tokens, so the agent understands the
|
|
83
|
-
codebase, not just the open file.
|
|
84
|
-
- **Session memory** — automatic compaction plus a running state summary that survives
|
|
85
|
-
it, and the agent can read its own earlier sessions in a project.
|
|
86
|
-
- **Project notes** — MINDWEAVE.md is loaded every session and maintained by the agent;
|
|
87
|
-
`@./path` imports split it, a per-folder one applies only there, and `~/.mindweave/`
|
|
88
|
-
holds machine-wide notes. `/init` writes the first one.
|
|
89
|
-
- **MCP servers** — connect external tool servers with `/mcp add` or in plain words;
|
|
90
|
-
their output is untrusted by default. [docs/MCP.md](docs/MCP.md)
|
|
91
|
-
- **Images and web search** — drop a screenshot or write `@shot.png`; ask about a recent
|
|
92
|
-
release and it looks it up, through your own provider.
|
|
93
|
-
- **Seeing your app** — it can capture one named window (never the whole screen, and it
|
|
94
|
-
asks first) to tell an app that started from one that works.
|
|
95
|
-
- **Per-project governor** — standing rules, reusable skills, and forbidden paths or
|
|
96
|
-
commands the agent must respect.
|
|
97
|
-
|
|
98
|
-
## Using it
|
|
99
|
-
|
|
100
|
-
| Command | What it does |
|
|
101
|
-
| --- | --- |
|
|
102
|
-
| `/help` | Lists every command |
|
|
103
|
-
| `/init` | Writes MINDWEAVE.md, the project notes loaded every session |
|
|
104
|
-
| `/provider` · `/model` · `/think` | Who answers, which model, how hard it reasons |
|
|
105
|
-
| `/clear` · `/continue` | Start fresh, or resume an earlier session |
|
|
106
|
-
| `/undo` | Reverts what the last turn changed |
|
|
107
|
-
| `/update` | Installs the newest version and reopens on this conversation |
|
|
108
|
-
| `/mcp` | Manages connected MCP servers |
|
|
109
|
-
| `/feedback` | Sends the maintainer a message, no account needed |
|
|
110
|
-
| `shift-tab` | Cycles interaction modes |
|
|
111
|
-
|
|
112
|
-
Type while it works and your message queues; press up to take it back and edit it.
|
|
113
|
-
|
|
114
|
-
## Read more
|
|
115
|
-
|
|
116
|
-
| | |
|
|
117
|
-
| --- | --- |
|
|
118
|
-
| [CHANGELOG.md](CHANGELOG.md) | What changed, and what each fix actually was |
|
|
119
|
-
| [KNOWN-ISSUES.md](KNOWN-ISSUES.md) | What is broken or unfinished, written down rather than carried quietly |
|
|
120
|
-
| [PHILOSOPHY.md](PHILOSOPHY.md) | How the project is run and what gets into the core. Short, and the honest version |
|
|
121
|
-
| [BOUNDARY.md](BOUNDARY.md) | What belongs in the core versus a driver |
|
|
122
|
-
| [CONTRIBUTING.md](CONTRIBUTING.md) | Mechanics, and what is most useful to report |
|
|
123
|
-
| [SECURITY.md](SECURITY.md) | Reporting a vulnerability |
|
|
124
|
-
| [docs/MCP.md](docs/MCP.md) | Connecting and trusting MCP servers |
|
|
125
|
-
|
|
126
|
-
## Contributing
|
|
127
|
-
|
|
128
|
-
Contributions are welcome, especially **model drivers**: Ollama is a stub waiting for
|
|
129
|
-
someone, and a driver is a smaller job than people expect, owning one provider's wire
|
|
130
|
-
format and nothing about how the agent behaves.
|
|
131
|
-
|
|
132
|
-
Small fixes and reproduced bugs with a failing test can go straight to a pull request.
|
|
133
|
-
For anything larger, start a Discussion first. AI-assisted contributions are fine; the
|
|
134
|
-
one rule is that you understand and have tested what you are submitting.
|
|
135
|
-
|
|
136
|
-
Bug reports are genuinely the most useful thing you can send. Mindweave is developed by
|
|
137
|
-
running it on real projects and fixing what breaks, and nearly everything in the
|
|
138
|
-
changelog started as a failure someone watched happen. [What to include, and what is
|
|
139
|
-
especially worth reporting.](CONTRIBUTING.md#reporting-a-bug)
|
|
140
|
-
|
|
141
|
-
Questions are welcome at zallinimann@gmail.com
|
|
142
|
-
|
|
143
|
-
## License
|
|
144
|
-
|
|
145
|
-
[Apache License 2.0](LICENSE).
|
|
1
|
+
<h1 align="center">Mindweave (mwcode)</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
A fast, model-adaptive, terminal-native AI coding agent.<br>
|
|
5
|
+
You bring your own key. It runs on your machine. Nothing goes anywhere else.
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
<p align="center">
|
|
9
|
+
<a href="LICENSE">Apache 2.0</a> •
|
|
10
|
+
<a href="https://x.com/mindweavecli">X</a> •
|
|
11
|
+
<a href="https://mindweavedev.netlify.app/">Website</a>
|
|
12
|
+
</p>
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## What it is
|
|
17
|
+
|
|
18
|
+
Mindweave is a coding agent that lives in your terminal and works inside your repository:
|
|
19
|
+
reading, searching, editing, running commands, and checking its own work.
|
|
20
|
+
|
|
21
|
+
It runs entirely on your machine. There is no backend, no telemetry and no account. Your
|
|
22
|
+
code and your API key never reach a Mindweave server, because there isn't one.
|
|
23
|
+
|
|
24
|
+
It is built lean on purpose. Most of a coding agent's context budget goes on scaffolding
|
|
25
|
+
the model never needed. Mindweave keeps prompts thin and leaves the room for the model to
|
|
26
|
+
reason about your code.
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
## Mindweave 1
|
|
30
|
+
|
|
31
|
+
Mindweave 1 is out, tagged `mindweave-1`. It is on npm, and the website is up. Install
|
|
32
|
+
with the steps below.
|
|
33
|
+
|
|
34
|
+
What landed in it is in the [changelog](CHANGELOG.md): fourteen model providers, a
|
|
35
|
+
rebuilt terminal interface, reworked prompt caching and token accounting, project notes
|
|
36
|
+
the agent maintains across sessions, and a long list of things that were quietly wrong.
|
|
37
|
+
|
|
38
|
+
## Install
|
|
39
|
+
|
|
40
|
+
Requires **Windows** and **Node.js 20+**. macOS and Linux are not supported yet, and the
|
|
41
|
+
reason is written down in [KNOWN-ISSUES.md](KNOWN-ISSUES.md) rather than glossed over.
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npm install -g mindweave
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Then, in any project:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
cd your-project
|
|
51
|
+
mindweave # or mw, for short
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
To build from source instead — for development, or to run an unreleased change:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
git clone https://github.com/mindweave-cli/Mindweave
|
|
58
|
+
cd Mindweave
|
|
59
|
+
npm install
|
|
60
|
+
npm run build
|
|
61
|
+
npm link # makes the `mindweave` command available globally
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
It asks for an API key on first launch and saves it to `~/.mindweave/.env`, so every
|
|
65
|
+
project afterwards just works. `mindweave --help` covers the launch flags; everything
|
|
66
|
+
else is configured inside a session.
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## What it can do
|
|
70
|
+
|
|
71
|
+
Short version, one line each. The depth is in the linked pages.
|
|
72
|
+
|
|
73
|
+
- **15 providers, 60 models, one key** — DeepSeek, Anthropic, OpenAI, Gemini, xAI,
|
|
74
|
+
Mistral, Groq, Cerebras, Qwen, Kimi, GLM, Meta, MiniMax, Tencent, plus every
|
|
75
|
+
tool-capable model on OpenRouter. Only the driver you
|
|
76
|
+
use is loaded. Switch with `/provider` and `/model`; remembered per project.
|
|
77
|
+
[PROVIDERS.md](src/drivers/PROVIDERS.md)
|
|
78
|
+
- **Real tools** — read and edit files, multi-file edits, ripgrep search, a shell with
|
|
79
|
+
background jobs, and sub-agents. Every edit comes back with the language server's own
|
|
80
|
+
errors for that file. Read-before-edit is enforced, and `/undo` is a real net.
|
|
81
|
+
- **Deterministic code intelligence** — a background lane indexes your repo with
|
|
82
|
+
tree-sitter and language servers, costing no tokens, so the agent understands the
|
|
83
|
+
codebase, not just the open file.
|
|
84
|
+
- **Session memory** — automatic compaction plus a running state summary that survives
|
|
85
|
+
it, and the agent can read its own earlier sessions in a project.
|
|
86
|
+
- **Project notes** — MINDWEAVE.md is loaded every session and maintained by the agent;
|
|
87
|
+
`@./path` imports split it, a per-folder one applies only there, and `~/.mindweave/`
|
|
88
|
+
holds machine-wide notes. `/init` writes the first one.
|
|
89
|
+
- **MCP servers** — connect external tool servers with `/mcp add` or in plain words;
|
|
90
|
+
their output is untrusted by default. [docs/MCP.md](docs/MCP.md)
|
|
91
|
+
- **Images and web search** — drop a screenshot or write `@shot.png`; ask about a recent
|
|
92
|
+
release and it looks it up, through your own provider.
|
|
93
|
+
- **Seeing your app** — it can capture one named window (never the whole screen, and it
|
|
94
|
+
asks first) to tell an app that started from one that works.
|
|
95
|
+
- **Per-project governor** — standing rules, reusable skills, and forbidden paths or
|
|
96
|
+
commands the agent must respect.
|
|
97
|
+
|
|
98
|
+
## Using it
|
|
99
|
+
|
|
100
|
+
| Command | What it does |
|
|
101
|
+
| --- | --- |
|
|
102
|
+
| `/help` | Lists every command |
|
|
103
|
+
| `/init` | Writes MINDWEAVE.md, the project notes loaded every session |
|
|
104
|
+
| `/provider` · `/model` · `/think` | Who answers, which model, how hard it reasons |
|
|
105
|
+
| `/clear` · `/continue` | Start fresh, or resume an earlier session |
|
|
106
|
+
| `/undo` | Reverts what the last turn changed |
|
|
107
|
+
| `/update` | Installs the newest version and reopens on this conversation |
|
|
108
|
+
| `/mcp` | Manages connected MCP servers |
|
|
109
|
+
| `/feedback` | Sends the maintainer a message, no account needed |
|
|
110
|
+
| `shift-tab` | Cycles interaction modes |
|
|
111
|
+
|
|
112
|
+
Type while it works and your message queues; press up to take it back and edit it.
|
|
113
|
+
|
|
114
|
+
## Read more
|
|
115
|
+
|
|
116
|
+
| | |
|
|
117
|
+
| --- | --- |
|
|
118
|
+
| [CHANGELOG.md](CHANGELOG.md) | What changed, and what each fix actually was |
|
|
119
|
+
| [KNOWN-ISSUES.md](KNOWN-ISSUES.md) | What is broken or unfinished, written down rather than carried quietly |
|
|
120
|
+
| [PHILOSOPHY.md](PHILOSOPHY.md) | How the project is run and what gets into the core. Short, and the honest version |
|
|
121
|
+
| [BOUNDARY.md](BOUNDARY.md) | What belongs in the core versus a driver |
|
|
122
|
+
| [CONTRIBUTING.md](CONTRIBUTING.md) | Mechanics, and what is most useful to report |
|
|
123
|
+
| [SECURITY.md](SECURITY.md) | Reporting a vulnerability |
|
|
124
|
+
| [docs/MCP.md](docs/MCP.md) | Connecting and trusting MCP servers |
|
|
125
|
+
|
|
126
|
+
## Contributing
|
|
127
|
+
|
|
128
|
+
Contributions are welcome, especially **model drivers**: Ollama is a stub waiting for
|
|
129
|
+
someone, and a driver is a smaller job than people expect, owning one provider's wire
|
|
130
|
+
format and nothing about how the agent behaves.
|
|
131
|
+
|
|
132
|
+
Small fixes and reproduced bugs with a failing test can go straight to a pull request.
|
|
133
|
+
For anything larger, start a Discussion first. AI-assisted contributions are fine; the
|
|
134
|
+
one rule is that you understand and have tested what you are submitting.
|
|
135
|
+
|
|
136
|
+
Bug reports are genuinely the most useful thing you can send. Mindweave is developed by
|
|
137
|
+
running it on real projects and fixing what breaks, and nearly everything in the
|
|
138
|
+
changelog started as a failure someone watched happen. [What to include, and what is
|
|
139
|
+
especially worth reporting.](CONTRIBUTING.md#reporting-a-bug)
|
|
140
|
+
|
|
141
|
+
Questions are welcome at zallinimann@gmail.com
|
|
142
|
+
|
|
143
|
+
## License
|
|
144
|
+
|
|
145
|
+
[Apache License 2.0](LICENSE).
|
package/dist/cli/App.js
CHANGED
|
@@ -3035,7 +3035,7 @@ export function App({ resumeSessionId, initialScreen }) {
|
|
|
3035
3035
|
return (_jsx(TrustGate, { rows: rows, cwd: startCwd.current, breadth: trustBreadth, warning: breadthWarning(trustBreadth, startCwd.current), persists: trustPersists(trustBreadth), version: versionLabel(), docsUrl: MINDWEAVE_DOCS_URL, onTrust: () => {
|
|
3036
3036
|
rememberTrust(projectDir(startCwd.current), trustBreadth);
|
|
3037
3037
|
setTrustOpen(false);
|
|
3038
|
-
}, onQuit: () => exit() }));
|
|
3038
|
+
}, onQuit: () => process.exit(0) }));
|
|
3039
3039
|
}
|
|
3040
3040
|
// FIRST RUN: nothing can run yet, so offer every provider rather than one. The user
|
|
3041
3041
|
// adds as many keys as they like and continues when they are ready. See KeySetup.
|