About this project
Reasonix is an open-source (MIT) AI coding agent built around DeepSeek, distributed as a single self-contained Go binary. The README positions it as "a coding agent you can leave running," with one local engine reachable four ways: terminal (CLI/TUI), desktop app, browser, and editors through the Agent Client Protocol (ACP).
Key documented capabilities:
- Config-driven design: providers, the agent, enabled tools and plugins are declared in `reasonix.toml`, with no hardcoded models. DeepSeek ships as a preset, and any OpenAI-compatible endpoint can be added as a config entry. Two models (executor + planner) can optionally run together in separate cache-stable sessions.
- Plugin-driven extensibility: MCP servers contribute tools, prompts and resources; Extension Protocol v1 sidecars can intercept runtime events, contribute providers and structured UI, and ship versioned plugin packages. A Go SDK and starter are provided.
- Cache-aware context maintenance: startup injects a small stable environment summary, stale tool output is snipped or pruned before summary compaction, and the built-in tool schema contract is documented for regression review.
- Long-run safety features: plan mode, permissions, a workspace sandbox, and per-turn checkpoints with rewind, intended to keep autonomous runs readable and undoable.
Installation paths described in the README:
- Path A (CLI/TUI): `npm i -g reasonix` on any supported platform, or Homebrew on macOS (`brew install esengine/reasonix/reasonix`). Prebuilt archives for darwin/linux/windows on amd64/arm64 plus SHA256SUMS are attached to GitHub releases.
- Path B (Desktop app): downloads for macOS (universal .dmg/.zip), Windows (.exe installer or portable .zip, x64/ARM64) and Linux (.deb/.tar.gz, x64). Windows installers are code-signed via SignPath.io.
- Path C (VS Code extension): requires Path A first; the extension starts the local `reasonix acp` backend and adds chat, editor context, tool-call approvals, model selection and workspace sessions. Available on the Visual Studio Marketplace and Open VSX (extension ID `SivanLiu.reasonix-agent`).
- Path D (Build from source): CLI build needs Go 1.26+ with `GOTOOLCHAIN=auto`; `make build` and `make cross` produce binaries for six targets. The desktop build additionally needs Node 24+ and pnpm 10, and ships its own Chromium so no platform webview dependencies are required.
Quick start for the CLI includes `reasonix setup` to configure a provider and model, `reasonix` for an interactive session, and `reasonix run "..."` for one-shot tasks; `/init` generates project instructions inside a session. The desktop app is configured in-app and does not require the CLI commands.
Documentation covers a CLI reference, guide, configuration paths, ACP editor integration, subagent profiles, Context Engine v2, capability diagnostics, recovery and updates, a bot guide, checkpoints and rewind, a spec, task contracts and pause policy, tool contract, migration from 0.x, extension development, plugin packages and Manifest v1, and the Extension Protocol. The project is bilingual (English and Simplified Chinese) and hosts a Discord community for setup help and workflow showcases.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.