{"repo":"esengine/DeepSeek-Reasonix","free":true,"listed":false,"github":"https://github.com/esengine/DeepSeek-Reasonix","clone":"git clone https://github.com/esengine/DeepSeek-Reasonix.git","description":"DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.","language":"Go","stars":34642,"topics":["agent","agent-framework","ai-agent","ai-coding","cli","coding-agent","deepseek","developer-tools","ink","llm","prompt-caching","r1","terminal","tool-use","tui","typescript"],"license":"MIT","category":"ai_agent","readme_excerpt":"

\n \"Reasonix\"\n

\n\n

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

\n\n

\n \"npm\n \"CI\"/\n \"license\"/\n \"downloads\"/\n \"GitHub\n \"AtomGit\n \"contributors\"/\n \"Discussions\"/\n \"Discord\"/\n

\n\n

\n \"esengine/DeepSeek-Reasonix\n \"esengine/DeepSeek-Reasonix\n

\n\n
\n\n

Open source · MIT · a single Go binary

\n

A coding agent you can leave running.

\n

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.

\n\n
\n \n
\n\n
\n\n> [!IMPORTANT]\n> **Community · 加入社区** — bilingual Discord for setup help (`#help` / `#求助`), workflow showcases, and feature ideas. → ****\n\n
\n\n## Features\n\n- **Config-driven.** Providers, the agent, enabled tools, and plugins are all\n declared in `reasonix.toml`. No hardcoded models.\n- **Multi-model & composable.** DeepSeek ships as a preset; any\n OpenAI-compatible endpoint is a config entry, not new code. Optionally run\n two models together (executor + planner) in separate, cache-stable sessions.\n- **Plugin-driven.** MCP servers contribute tools, prompts, and resources;\n Extension Protocol v1 sidecars can also intercept runtime events, contribute\n Providers and structured UI, and ship versioned plugin packages.\n- **Cache-aware context maintenance.** Startup injects a small stable environment\n summary, stale tool output is snipped/pruned before summary compaction, and the\n built-in tool schema contract is documented for regression review.\n- **Zero-friction distribution.** `CGO_ENABLED=0` single binary; cross-compile\n to six targets with one command. The result is a fully self-contained static\n binary — nothing to install on the target machine beyond the binary itself.\n\n## Install\n\nChoose the path that matches how you want to use Reasonix. The CLI/TUI,\ndesktop app, and VS Code extension all use the same local Reasonix engine.\n\n### Path A: CLI / TUI\n\nInstall the native binary through npm on any supported platform, or use\nHomebrew on macOS:\n\n```sh\nnpm i -g reasonix # any OS; pulls the prebuilt native binary\nbrew install esengine/reasonix/reasonix # macOS\n```\n\nPrebuilt archives (`darwin|linux|windows × amd64|arm64`) and `SHA256SUMS` are on\nevery [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases).\n\n### Path B: Desktop app\n\nUse the [official download page](https://reasonix.io/?download=desktop#start)\nfor the latest desktop build.\n\n| Platform | Package | Architecture |\n| --- | --- | --- |\n| macOS | Universal `.dmg` or `.zip` | Apple Silicon / Intel |\n| Windows | Installer `.exe` or portable `.zip` | x64 / ARM64 |\n| Linux | `.deb` or `.tar.gz` | x64 |\n\nWindows installers are code-signed through [SignPath.io](https://signpath.io/)\nwith a free certificate provided by the [SignPath Foundation](https://signpath.org/).\n\n### Path C: VS Code extension\n\nComplete Path A first. The extension does not bundle the CLI; it starts your\nlocal `reasonix acp` backend and adds native chat, editor context, tool-call\napprovals, model selection, and workspace sessions.\n\n- **VS Code:** [install from Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent)\n- **VSCodium / Eclipse Theia:** [install from Open VSX Registry](https://open-vsx.org/extension/SivanLiu/reasonix-agent)\n- **Extension ID:** `SivanLiu.reasonix-agent` · [source and usage guide](https://github.com/SivanCola/reasonix-vscode)\n\n### Path D: Build from source\n\nClone the repository first:\n\n```sh\ngit clone https://github.com/esengine/DeepSeek-Reasonix.git\ncd DeepSeek-Reasonix\n```\n\n#### CLI\n\nThe CLI build requires **Go 1.25+**. The module pins a `toolchain` directive;\nkeep `GOTOOLCHAIN=auto` so Go downloads the pinned toolchain, or install it.\n\n```sh\nmake build # -> bin/reasonix(.exe)\nmake cross # -> dist/ (darwin|linux|windows × amd64|arm64)\n```\n\n#### Desktop\n\nThe desktop build additionally requires:\n\n- **Node 24+ and pnpm 10** (`npm install -g pnpm@10`) for the frontend\n- **Wails CLI** matching the shared `.wails-version` pin\n\n```sh\nmake wails-install\ncd desktop\nwails build\n```\n\nSee the [desktop build guide](desktop/README.md#prerequisites) for platform\nwebview dependencies and Linux build tags.\n\n## Quick start\n\n### CLI / TUI\n\nThese commands are for the CLI/TUI installed through Path A:\n\n```sh\nreasonix setup # configure a provider and model\nreasonix # start an interactive session\nreasonix run \"implement the TODOs in main.go\"\n```\n\nIn an interactive session, run `/init` when you want Reasonix to create project\ninstructions.\n\n### Desktop app\n\nDownload the installer for your platform from the\n[official download page](https://reasonix.io/?download=desktop#start), install\nand launch Reasonix, then configure a provider and model in the app. The CLI\ncommands above are not required for the desktop app.\n\nFor advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.md)**,\n**[Guide](./docs/GUIDE.md)**, and\n**[configuration paths](./docs/CONFIG_PATHS.md)**.\n\n## Documentation\n\n- **Getting started:** [Guide](./docs/GUIDE.md) · [CLI reference](./docs/CLI.md) ·\n [Configuration paths](./docs/CONFIG_PATHS.md) · [ACP editor integration](./docs/ACP.md)\n- **Features & troubleshooting:** [Subagent profiles](./docs/SUBAGENT_PROFILES.md) ·\n [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.md) ·\n [Capability diagnostics](./docs/CAPABILITY_DIAGNOSTICS.md) ·\n [Recovery and updates](./docs/RECOVERY.md) · [Bot guide](./docs/BOT_GUIDE.md) ·\n [Checkpoints & rewind](./docs/CHECKPOINTS.md)\n- **Engineering & migration:** [Spec](./docs/SPEC.md) ·\n [Task contracts & pause policy](./docs/TASK_CONTRACT.md) ·\n [Tool contract](./docs/TOOL_CONTRACT.md) · [Migrating from 0.x](./docs/MIGRATING.md)\n- **Extension development:** [Extensions](./docs/EXTENSIONS.md) ·\n [Plugin packages and Manifest v1](./docs/PLUGIN_PACKAGES.md) ·\n [Extension Protocol](./docs/EXTENSION_PROTOCOL.md) ·\n [Go SDK and starter](./sdk/go/README.md)\n\n## Star History\n\n\n \n \n \n