reasonix 2.31.0 → 2.33.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 +37 -3
  2. package/package.json +8 -8
package/README.md CHANGED
@@ -43,9 +43,9 @@
43
43
 
44
44
  <br/>
45
45
 
46
- <p align="center"><strong>Open source · MIT · a single Go binary</strong></p>
47
- <h3 align="center">A reliable coding agent for complex software engineering tasks.</h3>
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>
46
+ <p align="center"><strong>Open source · MIT · runs on your computer, model of your choice</strong></p>
47
+ <h3 align="center">An open-source coding agent for your terminal, desktop, browser and editor.</h3>
48
+ <p align="center">It reads your project, edits files and runs commands and tests. Have it ask before each step, or work on its own within limits you set. Files its edit tools changed can be rewound. New here? Start with the Studio desktop app.</p>
49
49
  <p align="center">Maintained by <strong>Huahui Yu</strong>.</p>
50
50
 
51
51
  > [!IMPORTANT]
@@ -57,6 +57,38 @@
57
57
 
58
58
  <br/>
59
59
 
60
+ ## What it is
61
+
62
+ Reasonix is an open-source AI coding assistant. The program runs on your computer; the AI model is a service you configure, which receives what it reads. You describe a task in plain language; it reads code, edits files and runs commands and tests inside the project folder you choose, and shows you each step.
63
+
64
+ You pick the model: a DeepSeek preset is built in, any OpenAI-compatible service is one config entry, and you pay the model provider directly.
65
+
66
+ ## What you get
67
+
68
+ - **Read, edit, run.** It reads code, edits files and runs tests and commands, all inside your project folder.
69
+ - **Permission levels.** Have it ask every time, or let everyday actions run on their own; your forbid rules always hold. To see the approach first, use plan mode: it starts work only once you approve.
70
+ - **Rewind.** A file is saved before it changes, so you can rewind by conversation turn without touching your git history. Only files its edit tools changed are covered, not what a shell command did.
71
+
72
+ ## 30-second start
73
+
74
+ Download, add a model key, open a project. New here? Start with the Studio desktop app.
75
+
76
+ 1. Download and install the desktop app, Reasonix Studio, from the [releases page](https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true).
77
+ 2. Open it and enter your model provider and key when asked.
78
+ 3. Open your project folder and write what you want, for example "add retry on failure to the http client".
79
+ 4. At the level you chose, it stops and asks before anything that needs your say-so. Allow it to continue, or refuse.
80
+
81
+ Prefer a terminal? Download the `reasonix` command-line tool, run `reasonix setup` to pick a model, then run `reasonix`. See [Install](#install) and [Quick start](#quick-start).
82
+
83
+ ## Four ways to use it
84
+
85
+ - **Desktop app (Studio).** A graphical app; the best place to start.
86
+ - **Terminal.** A full-screen text interface; `reasonix run "task"` also works in scripts.
87
+ - **Browser.** `reasonix web` opens a web interface on your own machine.
88
+ - **Editor.** Install the extension in VS Code; other editors that support ACP (Agent Client Protocol, a common way for an editor to connect to an AI assistant) can connect to `reasonix acp`.
89
+
90
+ All four are the same program underneath. What follows is for advanced users and contributors.
91
+
60
92
  ## Versions
61
93
 
62
94
  Reasonix ships on two lines. See the [version roadmap announcement](https://github.com/esengine/DeepSeek-Reasonix/discussions/10748) for the reasoning behind the split.
@@ -82,6 +114,8 @@ or reimplemented on 2.x where they fit the new architecture.
82
114
 
83
115
  ## Features
84
116
 
117
+ Technical highlights for advanced users.
118
+
85
119
  - **Config-driven.** Providers, the agent, enabled tools, and plugins are all
86
120
  declared in `reasonix.toml`. No hardcoded models.
87
121
  - **Multi-model & composable.** DeepSeek ships as a preset; any
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "reasonix",
3
- "version": "2.31.0",
3
+ "version": "2.33.0",
4
4
  "description": "Cache-first DeepSeek coding agent for the terminal.",
5
5
  "bin": {
6
6
  "reasonix": "bin/reasonix.js"
@@ -29,12 +29,12 @@
29
29
  "tui"
30
30
  ],
31
31
  "optionalDependencies": {
32
- "@reasonix/cli-darwin-arm64": "2.31.0",
33
- "@reasonix/cli-darwin-x64": "2.31.0",
34
- "@reasonix/cli-linux-arm64": "2.31.0",
35
- "@reasonix/cli-linux-x64": "2.31.0",
36
- "@reasonix/cli-win32-arm64": "2.31.0",
37
- "@reasonix/cli-win32-x64": "2.31.0"
32
+ "@reasonix/cli-darwin-arm64": "2.33.0",
33
+ "@reasonix/cli-darwin-x64": "2.33.0",
34
+ "@reasonix/cli-linux-arm64": "2.33.0",
35
+ "@reasonix/cli-linux-x64": "2.33.0",
36
+ "@reasonix/cli-win32-arm64": "2.33.0",
37
+ "@reasonix/cli-win32-x64": "2.33.0"
38
38
  },
39
- "reasonixCandidateSha": "44e9492be4088d51c742bb7ca305719fe7f2c230"
39
+ "reasonixCandidateSha": "5e17135b6fa1c90f6f2f4ae45957d12159fe0e7e"
40
40
  }