English  ·  简体中文  ·  Guide  ·  ACP  ·  Extensions  ·  Spec  ·  Website  ·  Discord  ·  QQ

Open source · MIT · a single Go binary

A reliable coding agent for complex software engineering tasks.

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.

Maintained by Huahui Yu.

[!IMPORTANT] Community · 加入社区 — bilingual Discord for setup help (#help / #求助), workflow showcases, and feature ideas. → https://discord.gg/XF78rEME2D

QQ group DeepSeek-Reasonix 官方群 (1093562660) → https://qm.qq.com/q/i59b0z2R8s (QR code)

Douyin: 做游戏的小鱼 (Douyin ID 22703872788) · QR code

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, pre-release	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

• Config-driven. Providers, the agent, enabled tools, and plugins are all declared in reasonix.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=0 single 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.*, published as pre-releases while 2.x is in active development):

Platform	Package	Architecture
macOS	.dmg or .zip	Apple Silicon (arm64) / Intel (amd64)
Windows	Installer -installer.exe or portable .zip	x64
Linux	.deb	x64

Every package ships with a .minisig signature, and the release carries SHA256SUMS. Once installed, Studio updates itself in place.

The same release also carries the 2.x reasonix CLI as archives for darwin|linux|windows × amd64|arm64.

Reasonix 1.x (stable)

The 1.x CLI installs through npm 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 the repository; studio builds 2.x and main-v2 builds 1.x:

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
git switch studio

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.

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
• Features & troubleshooting: Subagent profiles · Context Engine v2 · Capability diagnostics · Recovery and updates · Checkpoints & rewind
• 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	esengine	ttmouse	lifu963
reasonix	HUQIANTAO	GTC2080	mchenziyi
Li-Charles-One	merge-order-check	light-front-theory	Yan Li
eghrhegpe	wufengfan	Bernardxu123	HaoyueQin
CVEngineer66	KHG420	JesonChou	SuMuxi66

Special thanks to Bernardxu123 for designing the project logo and intro video.

---

_{MIT — see LICENSE
Built by the community at esengine/DeepSeek-Reasonix}

---

_{Support this project}

If Reasonix has been useful and you'd like to say thanks, you can. It stays a coffee, not a contract — donations don't buy feature priority or change how issues get triaged.

• International — PayPal: paypal.me/yuhuahui
• 国内 — 微信支付 / 支付宝（扫码）