English · 简体中文 · Guide · ACP · Extensions · Spec · Website · Discord
A DeepSeek-native AI coding agent for your terminal.
A config- and plugin-driven harness — a single static Go binary, tuned around DeepSeek's prefix cache so token costs stay low across long sessions.
Important
Community · 加入社区 — bilingual Discord for setup help ( #help / #求助 ), workflow showcases, and feature ideas. → https://discord.gg/XF78rEME2D
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 only dependency is a TOML parser.
Install
Choose the path that matches how you want to use Reasonix. The CLI/TUI, desktop app, and VS Code extension all use the same local Reasonix engine.
Path A: CLI / TUI
Install the native binary through npm on any supported platform, or use Homebrew on macOS:
Prebuilt archives ( darwin|linux|windows × amd64|arm64 ) and SHA256SUMS are on every GitHub release .
Path B: Desktop app
Use the official download page for the latest desktop build.
Windows installers are code-signed through SignPath.io with a free certificate provided by the SignPath Foundation .
Path C: VS Code extension
Complete Path A first. 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.
VS Code: install from Visual Studio Marketplace
VSCodium / Eclipse Theia: install from Open VSX Registry
Extension ID: SivanLiu.reasonix-agent · source and usage guide
Path D: Build from source
Quick start
CLI / TUI
These commands are for the CLI/TUI installed through Path A:
In an interactive session, run /init when you want Reasonix to create project instructions.
Desktop app
Download the installer for your platform from the official download page , install and launch Reasonix, then configure a provider and model in the app. The CLI commands above are not required for the desktop app.
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 · Bot guide · Checkpoints & rewind
Engineering & migration: Spec · Task contracts & pause policy · Tool contract · Migrating from 0.x
Extension development: 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 .
Also a separate thank-you to Bernardxu123 for designing the project logo, and to AIGC Link for promoting the project on XiaoHongShu.
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
国内 — 微信支付（扫码）