DeepSeek-Reasonix-rs
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
A local-first AI coding agent: Go kernel with a Tauri + Vue desktop shell, CLI, and zero-install web access through a self-hosted relay. No account required.
[!NOTE]
DeepSeek-Reasonix-rs is a Rust + Vue + Tauri rewrite adapted from DeepSeek-Reasonix. Reasonix is no longer maintained as of 2026-11-12 (final release v2.61.0, MIT-licensed); this rewrite carries it forward.
English · 简体中文 · Guide · ACP · Extensions · Spec
Open source · MIT · runs on your computer, model of your choice
An open-source coding agent for your terminal, desktop, browser and editor.
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.
Maintained by @1012905. Adapted from Reasonix by Huahui Yu.
What it is
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.
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.
What you get
- Read, edit, run. It reads code, edits files and runs tests and commands, all inside your project folder.
- 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.
- 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.
30-second start
Download, add a model key, open a project. New here? Start with the Studio desktop app.
- Download and install the desktop app, Reasonix Studio, from this
repository's releases — everystudio-v*tag packages
Studio and thereasonixCLI. No tag in this repository yet?
Build from source. - Open it and enter your model provider and key when asked.
- Open your project folder and write what you want, for example "add retry on failure to the http client".
- At the level you chose, it stops and asks before anything that needs your say-so. Allow it to continue, or refuse.
Prefer a terminal? The release archives carry the reasonix CLI beside the Studio packages (or build it from source); run reasonix setup to pick a model, then run reasonix. See Install and Quick start.
Four ways to use it
- Desktop app (Studio). A graphical app; the best place to start.
- Terminal. A full-screen text interface;
reasonix run "task"also works in scripts. - Browser.
reasonix webopens a web interface on your own machine. - 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.
All four are the same program underneath. What follows is for advanced users and contributors.
Use it from DeepSeek Harness
DeepSeek Harness (dsh) can hand a task to Reasonix as a subagent over ACP. This repository publishes a plugin index for it:
- Run
reasonix setupon the machine that runsdsh. In the DSH Web UI turn on Custom plugin markets (Plugins, More) and add this index in the Discover tab:https://raw.githubusercontent.com/1012905/DeepSeek-Reasonix-rs/studio/integrations/dsh-plugin/market-index.json - Install "Reasonix subagent" from it.
- Open the plugin's page and turn its switch on. While it is off the model has no
reasonixtool and may runreasonix -pin its own shell, which looks like a delegation and is not one.
Setup details, the permission policy and limits are in Using Reasonix from DeepSeek Harness.
Versions
Reasonix ships on two lines. See the version roadmap announcement for the reasoning behind the split.
| Line | Branch | Status | Get it |
|---|---|---|---|
| Reasonix 2.x | studio (this branch) |
Active development | Studio releases |
| Reasonix 1.x | main-v2 |
Maintenance / stable | npm i -g reasonix · desktop download |
- Want something stable? Stay on 1.x. It keeps receiving bug fixes,
provider/API compatibility, updater and security fixes; its core architecture
is no longer being extended. - Want the new architecture? Use 2.x Reasonix Studio. It is still moving
quickly; reports are welcome.
Valuable fixes, tests and behaviour from 1.x are reviewed one by one and ported
or reimplemented on 2.x where they fit the new architecture.
- Moving from 1.x to 2.x: what the two lines share, and
how to run both on one machine without losing sessions. - 2.x roadmap: what 2.x still has to deliver, how it ships,
and the decisions still open.
Features
Technical highlights for advanced users.
- Config-driven. Providers, the agent, enabled tools, and plugins are all
declared inreasonix.toml. No hardcoded models. - Multi-model & composable. DeepSeek ships as a preset; any
OpenAI-compatible endpoint is a config entry, not new code. Optionally run
two models together (executor + planner) in separate, cache-stable sessions. - Plugin-driven. MCP servers contribute tools, prompts, and resources;
Extension Protocol v1 sidecars can also intercept runtime events, contribute
Providers and structured UI, and ship versioned plugin packages. - Cache-aware context maintenance. Startup injects a small stable environment
summary, stale tool output is snipped/pruned before summary compaction, and the
built-in tool schema contract is documented for regression review. - Zero-friction distribution.
CGO_ENABLED=0single binary; cross-compile
to six targets with one command. The result is a fully self-contained static
binary — nothing to install on the target machine beyond the binary itself.
Install
This branch is Reasonix 2.x. Its desktop app is Reasonix Studio; the CLI,
Studio, and editor integrations all run the same local Reasonix engine.
Reasonix Studio (2.x)
Download the package for your platform from the latest
Studio release
(tagged studio-v2.*; candidates such as -rc.N are marked as
pre-releases):
| Platform | Package | Architecture |
|---|---|---|
| macOS | .dmg or .zip |
Apple Silicon (arm64) / Intel (amd64) |
| Windows | Installer -installer.exe or portable .zip |
x64 |
| Linux | .deb, .rpm, or .AppImage (download only) |
x64 (amd64) / ARM64 (arm64, aarch64) |
No studio-v* tag has been cut in this repository yet — until the first
one, build from source. The pipeline that produces
these artifacts is documented.
Every package ships with a .minisig signature, and the release carriesSHA256SUMS. Once installed, Studio updates itself in place.
The same release also carries the 2.x reasonix CLI as archives fordarwin|linux|windows × amd64|arm64.
The npm and Homebrew channels still belong to the upstream 1.x line — this
repository's CLI ships as release archives and from source. Publishing to
npm or Homebrew from this line is gated behind STUDIO_PUBLISHES_CLI and
awaits its own endpoints (the npm reasonix name and the tap are
upstream's).
Reasonix 1.x (upstream)
The 1.x line lives on the upstream repository; its channels install from
there on any supported platform, or Homebrew on macOS:
npm i -g reasonix # any OS; pulls the prebuilt native binary
brew install esengine/reasonix/reasonix # macOS
The 1.x desktop app is on the
official download page. Windows
installers are code-signed with a Certum code-signing certificate.
VS Code extension
The extension does not bundle the CLI; it starts your local reasonix acp
backend and adds native chat, editor context, tool-call approvals, model
selection, and workspace sessions. Install the 1.x CLI first.
- VS Code: install from Visual Studio Marketplace
- VSCodium / Eclipse Theia: install from Open VSX Registry
- Extension ID:
SivanLiu.reasonix-agent· source and usage guide
Build from source
Clone this repository; studio is its only line and builds 2.x (the upstream
1.x line lives on
esengine/DeepSeek-Reasonix):
git clone https://github.com/1012905/DeepSeek-Reasonix-rs.git
cd DeepSeek-Reasonix-rs
CLI
The CLI build requires Go 1.25+. The module pins a toolchain directive;
keep GOTOOLCHAIN=auto so Go downloads the pinned toolchain, or install it.
make build # -> bin/reasonix(.exe)
make cross # -> dist/ (darwin|linux|windows × amd64|arm64)
Studio
Studio additionally requires Node 24+ and pnpm 10
(npm install -g pnpm@10) for the frontend.
make studio
See the Studio build guide for platform
webview dependencies and Linux build tags.
Studio Tauri shell (desktop-tauri)
The Tauri shell is the target desktop stack (Rust + Vue) and runs beside the
Electron shell during the transition. It needs Node 24+, pnpm 10 and a stable
Rust toolchain; on Linux, cargo also needs the Tauri system libraries
(libwebkit2gtk-4.1-dev, libgtk-3-dev, libayatana-appindicator3-dev,librsvg2-dev).
make studio-tauri-test # frontend build + vitest wire-parity witness
make studio-tauri-check # cargo check of the Rust shell
Quick start
Reasonix Studio
Install and launch Studio, then connect a provider and model in the app. No CLI
setup is needed.
CLI / TUI
reasonix setup # configure a provider and model
reasonix # start an interactive session
reasonix run "implement the TODOs in main.go"
In an interactive session, run /init when you want Reasonix to create project
instructions.
For advanced CLI usage and configuration, see the CLI reference,
Guide, and
configuration paths.
Documentation
- Getting started: Guide · CLI reference ·
Configuration paths · ACP editor integration ·
Use from DeepSeek Harness - Features & troubleshooting: Subagent profiles ·
Context Engine v2 ·
Capability diagnostics ·
Recovery and updates ·
Checkpoints & rewind - Agent presets: Session Agent compositions
- Engineering & migration: Spec ·
Task contracts & pause policy ·
Tool contract · Moving from 1.x to 2.x ·
2.x roadmap - Extension development: Skills · Extensions ·
Plugin packages and Manifest v1 ·
Extension Protocol ·
Go SDK and starter
Star History
Acknowledgments
A small list of folks whose work has shaped Reasonix the most — the current top
20 contributors by commit count. The full contributor graph is on
GitHub.
| Contributor | Contributor | Contributor | Contributor |
|---|---|---|---|
| SivanCola | KHG420 | ttmouse | chuiwenwei |
| lifu963 | XTLine | HUQIANTAO | xxoingr |
| Harbor404 | GTC2080 | mchenziyi | Li-Charles-One |
| light-front-theory | imcreazy | eghrhegpe | noreply |
| par73e | Bernardxu123 | lancy69 | Guan0923 |
Special thanks to Bernardxu123 for designing the project logo and intro video.
MIT — see LICENSE
Built by the community at esengine/DeepSeek-Reasonix
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found