DeepSeek-Reasonix

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

[!IMPORTANT] Reasonix 1.0 is a ground-up rewrite in Go — this branch (main-v2) is the new default and where development happens now. The earlier 0.x TypeScript releases are legacy, living on the v1 branch (maintenance only). See the migration guide. npm i -g reasonix stays the install command — 1.0.0+ delivers the Go binary, 0.x is the legacy TS build.

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. 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.

Install

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.

Code signing

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

Build from source

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

Quick start

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

Configuration

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; starting with Reasonix v1.8.1, the user file lives at ~/.reasonix/config.toml on macOS/Linux and %AppData%\reasonix\config.toml on Windows. See Configuration paths for migration details. Secrets come from the environment via api_key_env, are never written to config files, and new keys default to the OS credential store with a Reasonix-owned file fallback. Project .env files are read as a compatibility override, but Reasonix does not write new keys there. Permissions, the sandbox, plugins (MCP), slash commands, @ references, and two-model setup are all in the Guide.

Documentation

• 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).

Star History

Support

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

Acknowledgments

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.

---

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