Reasonix

English · 简体中文 · Guide · Spec · Website · Discord

npm version CI license downloads GitHub stars AtomGit stars contributors Discussions Discord

oosmetrics — Top 2 in Agents by velocity oosmetrics — Top 3 in LLMs by velocity oosmetrics — Top 3 in CLI by velocity

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.

• Config-driven. Providers, the agent, enabled tools, and plugins are all declared in reasonix.toml. No hardcoded models.
• Multi-model & composable. DeepSeek (flash/pro) and MiMo ship as presets; 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. External tools run as subprocesses over stdio JSON-RPC (MCP-compatible). Built-in tools self-register at compile time.
• Zero-friction distribution. CGO_ENABLED=0 single binary; cross-compile to six targets with one command. The only dependency is a TOML parser.

npm i -g reasonix # any OS; pulls the prebuilt native binary
brew install esengine/reasonix/reasonix # macOS

Prebuilt archives (darwin|linux|windows ×ばつ amd64|arm64) and SHA256SUMS are on every GitHub release.

Windows builds are code-signed with a free certificate provided by the SignPath Foundation, with signing through SignPath.io.

make build # -> bin/reasonix(.exe)
make cross # -> dist/ (darwin|linux|windows ×ばつ amd64|arm64)

reasonix setup # config wizard → ./reasonix.toml
export DEEPSEEK_API_KEY=sk-... # or put it in .env (see .env.example)
reasonix chat # then run /init to generate AGENTS.md (project memory)
reasonix run "implement the TODOs in main.go"
reasonix run --model mimo-pro "add unit tests for this function"
echo "explain this code" | reasonix run

A minimal reasonix.toml — one provider and a default model — is enough to start:

default_model = "deepseek-flash"
[[providers]]
name = "deepseek-flash"
kind = "openai"
base_url = "https://api.deepseek.com"
model = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"

Resolution order is flag > ./reasonix.toml > the user config file > built-in defaults; the user file lives in your OS config dir — ~/.config/reasonix/ on Linux, ~/Library/Application Support/reasonix/ on macOS, %AppData%\reasonix\ on Windows. Secrets come from the environment via api_key_env and are never written to config files. Permissions, the sandbox, plugins (MCP), slash commands, @ references, and two-model setup are all in the Guide .

• Guide — configuration, permissions & sandbox, plugins (MCP), slash commands, @ references, two-model collaboration.
• Bot guide — connect Feishu, Lark, and WeChat bots from the desktop app, then use approvals, YOLO, and commands from IM.
• Spec — engineering contract: architecture, registries, data types, and roadmap.
• Migrating from 0.x — moving from the legacy TypeScript releases to the 1.0 Go rewrite.
• Checkpoints & rewind — the snapshot-based edit safety net (Esc-Esc / /rewind).

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
• 国内 — 微信支付(扫码)

WeChat Pay QR code

A small list of folks whose work has shaped Reasonix the most — measured by both commit count and code volume. Listed alphabetically, no ordering of importance. The full contributor graph is on GitHub.

• ctharvey
• dimasd-angga (Dimas D. Angga)
• Evan-Pycraft
• ForeverYoungPp
• GTC2080 (TaoMu)
• kabaka9527
• lisniuse (Richie)
• wade19990814-hue
• wviana (Wesley Viana)

Also a separate thank-you to Bernardxu123 for designing the project logo, and to AIGC Link for promoting the project on XiaoHongShu.

Contributors to esengine/DeepSeek-Reasonix

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