reasonix 1.39.7 → 2.29.0

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 +86 -55
  2. package/package.json +8 -9
package/README.md CHANGED
@@ -18,9 +18,12 @@
18
18
  <a href="https://esengine.github.io/DeepSeek-Reasonix/">Website</a>
19
19
  &nbsp;·&nbsp;
20
20
  <strong><a href="https://discord.gg/XF78rEME2D">Discord</a></strong>
21
+ &nbsp;·&nbsp;
22
+ <strong><a href="https://qm.qq.com/q/i59b0z2R8s">QQ</a></strong>
21
23
  </p>
22
24
 
23
25
  <p align="center">
26
+ <a href="https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true"><img src="https://img.shields.io/github/v/release/esengine/DeepSeek-Reasonix.svg?filter=studio-v*&include_prereleases&style=flat-square&color=8250df&labelColor=161b22&label=studio%202.x" alt="Reasonix Studio 2.x"/></a>
24
27
  <a href="https://www.npmjs.com/package/reasonix"><img src="https://img.shields.io/npm/v/reasonix.svg?style=flat-square&color=cb3837&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a>
25
28
  <a href="https://github.com/esengine/DeepSeek-Reasonix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/esengine/DeepSeek-Reasonix/ci.yml?style=flat-square&label=ci&labelColor=161b22&logo=githubactions&logoColor=white" alt="CI"/></a>
26
29
  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/reasonix.svg?style=flat-square&color=8b949e&labelColor=161b22" alt="license"/></a>
@@ -30,6 +33,7 @@
30
33
  <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors"><img src="https://img.shields.io/github/contributors/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=bc8cff&labelColor=161b22&logo=github&logoColor=white" alt="contributors"/></a>
31
34
  <a href="https://github.com/esengine/DeepSeek-Reasonix/discussions"><img src="https://img.shields.io/github/discussions/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=58a6ff&labelColor=161b22&logo=github&logoColor=white" alt="Discussions"/></a>
32
35
  <a href="https://discord.gg/XF78rEME2D"><img src="https://img.shields.io/badge/discord-join-5865F2.svg?style=flat-square&labelColor=161b22&logo=discord&logoColor=white" alt="Discord"/></a>
36
+ <a href="https://qm.qq.com/q/i59b0z2R8s"><img src="https://img.shields.io/badge/QQ%20group-1093562660-12B7F5.svg?style=flat-square&labelColor=161b22&logo=tencentqq&logoColor=white" alt="QQ group 1093562660"/></a>
33
37
  </p>
34
38
 
35
39
  <p align="center">
@@ -40,20 +44,42 @@
40
44
  <br/>
41
45
 
42
46
  <p align="center"><strong>Open source · MIT · a single Go binary</strong></p>
43
- <h3 align="center">A coding agent you can leave running.</h3>
47
+ <h3 align="center">A reliable coding agent for complex software engineering tasks.</h3>
44
48
  <p align="center">One local engine, four ways in — terminal, desktop app, browser, or your editor over ACP. Plan mode, permissions, a workspace sandbox and per-turn checkpoints keep a long autonomous run something you can still read and undo.</p>
45
-
46
- <div align="center">
47
- <video src="https://github.com/user-attachments/assets/ab2f3878-e224-4931-8254-060e7695cfb9" controls preload="metadata" width="560"></video>
48
- </div>
49
-
50
- <br/>
49
+ <p align="center">Maintained by <strong>Huahui Yu</strong>.</p>
51
50
 
52
51
  > [!IMPORTANT]
53
52
  > **Community · 加入社区** — bilingual Discord for setup help (`#help` / `#求助`), workflow showcases, and feature ideas. → **<https://discord.gg/XF78rEME2D>**
53
+ >
54
+ > QQ group **DeepSeek-Reasonix官方群** (`1093562660`) → **<https://qm.qq.com/q/i59b0z2R8s>** ([QR code](./docs/assets/qq-group.svg))
55
+
56
+ > Douyin: **做游戏的小鱼** (Douyin ID `22703872788`) · [QR code](./docs/assets/douyin.png)
54
57
 
55
58
  <br/>
56
59
 
60
+ ## Versions
61
+
62
+ Reasonix ships on two lines. See the [version roadmap announcement](https://github.com/esengine/DeepSeek-Reasonix/discussions/10748) for the reasoning behind the split.
63
+
64
+ | Line | Branch | Status | Get it |
65
+ | --- | --- | --- | --- |
66
+ | **Reasonix 2.x** | `studio` (this branch) | Active development | [Studio releases](https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true) |
67
+ | **Reasonix 1.x** | [`main-v2`](https://github.com/esengine/DeepSeek-Reasonix/tree/main-v2) | Maintenance / stable | `npm i -g reasonix` · [desktop download](https://reasonix.io/?download=desktop#start) |
68
+
69
+ - **Want something stable?** Stay on 1.x. It keeps receiving bug fixes,
70
+ provider/API compatibility, updater and security fixes; its core architecture
71
+ is no longer being extended.
72
+ - **Want the new architecture?** Use 2.x Reasonix Studio. It is still moving
73
+ quickly; reports are welcome.
74
+
75
+ Valuable fixes, tests and behaviour from 1.x are reviewed one by one and ported
76
+ or reimplemented on 2.x where they fit the new architecture.
77
+
78
+ - [Moving from 1.x to 2.x](./docs/MIGRATING.md): what the two lines share, and
79
+ how to run both on one machine without losing sessions.
80
+ - [2.x roadmap](./docs/ROADMAP.md): what 2.x still has to deliver, how it ships,
81
+ and the decisions still open.
82
+
57
83
  ## Features
58
84
 
59
85
  - **Config-driven.** Providers, the agent, enabled tools, and plugins are all
@@ -73,57 +99,65 @@
73
99
 
74
100
  ## Install
75
101
 
76
- Choose the path that matches how you want to use Reasonix. The CLI/TUI,
77
- desktop app, and VS Code extension all use the same local Reasonix engine.
102
+ This branch is **Reasonix 2.x**. Its desktop app is Reasonix Studio; the CLI,
103
+ Studio, and editor integrations all run the same local Reasonix engine.
78
104
 
79
- ### Path A: CLI / TUI
105
+ ### Reasonix Studio (2.x)
80
106
 
81
- Install the native binary through npm on any supported platform, or use
82
- Homebrew on macOS:
107
+ Download the package for your platform from the latest
108
+ [Studio release](https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true)
109
+ (tagged `studio-v2.*`; candidates such as `-rc.N` are marked as
110
+ pre-releases):
83
111
 
84
- ```sh
85
- npm i -g reasonix # any OS; pulls the prebuilt native binary
86
- brew install esengine/reasonix/reasonix # macOS
87
- ```
112
+ | Platform | Package | Architecture |
113
+ | --- | --- | --- |
114
+ | macOS | `.dmg` or `.zip` | Apple Silicon (`arm64`) / Intel (`amd64`) |
115
+ | Windows | Installer `-installer.exe` or portable `.zip` | x64 |
116
+ | Linux | `.deb` | x64 |
88
117
 
89
- Prebuilt archives (`darwin|linux|windows × amd64|arm64`) and `SHA256SUMS` are on
90
- every [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases).
118
+ Every package ships with a `.minisig` signature, and the release carries
119
+ `SHA256SUMS`. Once installed, Studio updates itself in place.
91
120
 
92
- ### Path B: Desktop app
121
+ The same release also carries the 2.x `reasonix` CLI as archives for
122
+ `darwin|linux|windows × amd64|arm64`.
93
123
 
94
- Use the [official download page](https://reasonix.io/?download=desktop#start)
95
- for the latest desktop build.
124
+ ### Reasonix 1.x (stable)
96
125
 
97
- | Platform | Package | Architecture |
98
- | --- | --- | --- |
99
- | macOS | Universal `.dmg` or `.zip` | Apple Silicon / Intel |
100
- | Windows | Installer `.exe` or portable `.zip` | x64 / ARM64 |
101
- | Linux | `.deb` or `.tar.gz` | x64 |
126
+ The 1.x CLI installs through npm on any supported platform, or Homebrew on
127
+ macOS:
102
128
 
103
- Windows installers are code-signed with a Certum code-signing certificate.
129
+ ```sh
130
+ npm i -g reasonix # any OS; pulls the prebuilt native binary
131
+ brew install esengine/reasonix/reasonix # macOS
132
+ ```
133
+
134
+ The 1.x desktop app is on the
135
+ [official download page](https://reasonix.io/?download=desktop#start). Windows
136
+ installers are code-signed with a Certum code-signing certificate.
104
137
 
105
- ### Path C: VS Code extension
138
+ ### VS Code extension
106
139
 
107
- Complete Path A first. The extension does not bundle the CLI; it starts your
108
- local `reasonix acp` backend and adds native chat, editor context, tool-call
109
- approvals, model selection, and workspace sessions.
140
+ The extension does not bundle the CLI; it starts your local `reasonix acp`
141
+ backend and adds native chat, editor context, tool-call approvals, model
142
+ selection, and workspace sessions. Install the 1.x CLI first.
110
143
 
111
144
  - **VS Code:** [install from Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent)
112
145
  - **VSCodium / Eclipse Theia:** [install from Open VSX Registry](https://open-vsx.org/extension/SivanLiu/reasonix-agent)
113
146
  - **Extension ID:** `SivanLiu.reasonix-agent` · [source and usage guide](https://github.com/SivanCola/reasonix-vscode)
114
147
 
115
- ### Path D: Build from source
148
+ ### Build from source
116
149
 
117
- Clone the repository first:
150
+ Clone the repository; `studio` builds 2.x and `main-v2` builds 1.x:
118
151
 
119
152
  ```sh
120
153
  git clone https://github.com/esengine/DeepSeek-Reasonix.git
121
154
  cd DeepSeek-Reasonix
155
+ git switch studio
122
156
  ```
123
157
 
124
158
  #### CLI
125
159
 
126
- The CLI build requires **Go 1.26+**. The module pins a `toolchain` directive;
160
+ The CLI build requires **Go 1.25+**. The module pins a `toolchain` directive;
127
161
  keep `GOTOOLCHAIN=auto` so Go downloads the pinned toolchain, or install it.
128
162
 
129
163
  ```sh
@@ -131,23 +165,26 @@ make build # -> bin/reasonix(.exe)
131
165
  make cross # -> dist/ (darwin|linux|windows × amd64|arm64)
132
166
  ```
133
167
 
134
- #### Desktop
168
+ #### Studio
135
169
 
136
- The desktop build additionally requires **Node 24+ and pnpm 10**
137
- (`npm install -g pnpm@10`) for the frontend and the Electron shell:
170
+ Studio additionally requires **Node 24+ and pnpm 10**
171
+ (`npm install -g pnpm@10`) for the frontend.
138
172
 
139
173
  ```sh
140
- scripts/desktop-build.sh darwin/arm64 v0.0.0-dev # one platform per run
174
+ make studio
141
175
  ```
142
176
 
143
- No platform webview dependencies are needed — the shell ships its own
144
- Chromium. See the [desktop build guide](desktop/README.md#prerequisites).
177
+ See the [Studio build guide](desktop/README.md#prerequisites) for platform
178
+ webview dependencies and Linux build tags.
145
179
 
146
180
  ## Quick start
147
181
 
148
- ### CLI / TUI
182
+ ### Reasonix Studio
149
183
 
150
- These commands are for the CLI/TUI installed through Path A:
184
+ Install and launch Studio, then connect a provider and model in the app. No CLI
185
+ setup is needed.
186
+
187
+ ### CLI / TUI
151
188
 
152
189
  ```sh
153
190
  reasonix setup # configure a provider and model
@@ -158,13 +195,6 @@ reasonix run "implement the TODOs in main.go"
158
195
  In an interactive session, run `/init` when you want Reasonix to create project
159
196
  instructions.
160
197
 
161
- ### Desktop app
162
-
163
- Download the installer for your platform from the
164
- [official download page](https://reasonix.io/?download=desktop#start), install
165
- and launch Reasonix, then configure a provider and model in the app. The CLI
166
- commands above are not required for the desktop app.
167
-
168
198
  For advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.md)**,
169
199
  **[Guide](./docs/GUIDE.md)**, and
170
200
  **[configuration paths](./docs/CONFIG_PATHS.md)**.
@@ -175,14 +205,14 @@ For advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.m
175
205
  [Configuration paths](./docs/CONFIG_PATHS.md) · [ACP editor integration](./docs/ACP.md)
176
206
  - **Features & troubleshooting:** [Subagent profiles](./docs/SUBAGENT_PROFILES.md) ·
177
207
  [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.md) ·
178
- [File deliverables and the `present` tool](./docs/PRESENT_TOOL.md) ·
179
208
  [Capability diagnostics](./docs/CAPABILITY_DIAGNOSTICS.md) ·
180
- [Recovery and updates](./docs/RECOVERY.md) · [Bot guide](./docs/BOT_GUIDE.md) ·
209
+ [Recovery and updates](./docs/RECOVERY.md) ·
181
210
  [Checkpoints & rewind](./docs/CHECKPOINTS.md)
182
211
  - **Engineering & migration:** [Spec](./docs/SPEC.md) ·
183
212
  [Task contracts & pause policy](./docs/TASK_CONTRACT.md) ·
184
- [Tool contract](./docs/TOOL_CONTRACT.md) · [Migrating from 0.x](./docs/MIGRATING.md)
185
- - **Extension development:** [Extensions](./docs/EXTENSIONS.md) ·
213
+ [Tool contract](./docs/TOOL_CONTRACT.md) · [Moving from 1.x to 2.x](./docs/MIGRATING.md) ·
214
+ [2.x roadmap](./docs/ROADMAP.md)
215
+ - **Extension development:** [Skills](./docs/SKILLS.md) · [Extensions](./docs/EXTENSIONS.md) ·
186
216
  [Plugin packages and Manifest v1](./docs/PLUGIN_PACKAGES.md) ·
187
217
  [Extension Protocol](./docs/EXTENSION_PROTOCOL.md) ·
188
218
  [Go SDK and starter](./sdk/go/README.md)
@@ -212,7 +242,7 @@ A small list of folks whose work has shaped Reasonix the most — the current to
212
242
  | **reasonix** | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**mchenziyi**](https://github.com/mchenziyi) |
213
243
  | [**Li-Charles-One**](https://github.com/Li-Charles-One) | **merge-order-check** | [**light-front-theory**](https://github.com/light-front-theory) | **Yan Li** |
214
244
  | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** | [**Bernardxu123**](https://github.com/Bernardxu123) | [**HaoyueQin**](https://github.com/HaoyueQin) |
215
- | [**CVEngineer66**](https://github.com/CVEngineer66) | [**JesonChou**](https://github.com/JesonChou) | [**SuMuxi66**](https://github.com/SuMuxi66) | [**lanshi17**](https://github.com/lanshi17) |
245
+ | [**CVEngineer66**](https://github.com/CVEngineer66) | [**KHG420**](https://github.com/KHG420) | [**JesonChou**](https://github.com/JesonChou) | [**SuMuxi66**](https://github.com/SuMuxi66) |
216
246
  <!-- reasonix-top-contributors:end -->
217
247
 
218
248
  Special thanks to [**Bernardxu123**](https://github.com/Bernardxu123) for designing the project logo and intro video.
@@ -242,8 +272,9 @@ coffee, not a contract — donations don't buy feature priority or change how
242
272
  issues get triaged.
243
273
 
244
274
  - **International** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)
245
- - **国内** — 微信支付（扫码）
275
+ - **国内** — 微信支付 / 支付宝（扫码）
246
276
 
247
277
  <p align="center">
248
278
  <img src=".github/sponsor/wechat-pay.jpg" alt="WeChat Pay QR code" width="180"/>
279
+ <img src=".github/sponsor/alipay.jpg" alt="Alipay QR code" width="180"/>
249
280
  </p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "reasonix",
3
- "version": "1.39.7",
3
+ "version": "2.29.0",
4
4
  "description": "Cache-first DeepSeek coding agent for the terminal.",
5
5
  "bin": {
6
6
  "reasonix": "bin/reasonix.js"
@@ -29,13 +29,12 @@
29
29
  "tui"
30
30
  ],
31
31
  "optionalDependencies": {
32
- "@reasonix/cli-darwin-arm64": "1.39.7",
33
- "@reasonix/cli-darwin-x64": "1.39.7",
34
- "@reasonix/cli-linux-arm64": "1.39.7",
35
- "@reasonix/cli-linux-x64": "1.39.7",
36
- "@reasonix/cli-win32-arm64": "1.39.7",
37
- "@reasonix/cli-win32-x64": "1.39.7"
32
+ "@reasonix/cli-darwin-arm64": "2.29.0",
33
+ "@reasonix/cli-darwin-x64": "2.29.0",
34
+ "@reasonix/cli-linux-arm64": "2.29.0",
35
+ "@reasonix/cli-linux-x64": "2.29.0",
36
+ "@reasonix/cli-win32-arm64": "2.29.0",
37
+ "@reasonix/cli-win32-x64": "2.29.0"
38
38
  },
39
- "reasonixCandidateSha": "6dbabcbf7135c56ff5186b0cd36f5cc2725f47b4",
40
- "gitHead": "6dbabcbf7135c56ff5186b0cd36f5cc2725f47b4"
39
+ "reasonixCandidateSha": "9ce1b8ba5eab6245d1a95d508b496a20c8de952f"
41
40
  }