目录
#x27; -count=1 * ci: report-only agent complexity monitor / 增加 agent 复杂度报告模式监控 Problem: The repo already runs gofmt, vet, build, full tests, race, and golangci-lint, but had no trend signal for remaining internal/agent hotspots after structured extraction. Root cause: Main lint intentionally avoids funlen/cyclop hard fails that would generate a flood of pre-existing noise. Fix: - Add a report-only funlen+cyclop config scoped to internal/agent production code with generous thresholds (not a hard 50-line rule). - Run it beside the existing lint job with issues-exit-code=0, write a CI summary, and upload the report as an artifact. - Ignore the generated local report file. Verification: bash scripts/agent-complexity-report.sh * test(provider): isolate live DeepSeek cache probe / 隔离 DeepSeek 真实缓存探针 Problem: The environment-gated DeepSeek cache probe ran during ordinary test suites whenever a stale API key was present, and its diagnostics still claimed tool-call reasoning replay should have zero prompt-token cost. Root cause: The probe had no explicit live build tag and retained commentary from the obsolete policy that stripped reasoning_content from DeepSeek tool-call turns. Fix: Gate the probe behind the live build tag, document the tagged invocation, describe required replay versus the empty-key recovery fallback, and fail when the required replay request is rejected. Verification: - go test ./... - go test -race ./internal/provider/openai -count=1 - env -u DEEPSEEK_API_KEY go test -tags live ./internal/provider/openai -run TestRealDeepSeekCacheProbe -count=1 -v - go vet ./internal/provider/openai - ./scripts/cache-guard.sh" href="/louis_lifu/deepseek-reasonix/commits/26b256b5d5">refactor(agent): simplify run/tool state and harden live tests / 重构 Agent 状态并隔离真实测试 (#7010)4天前
  • .golangci.ymlci: suppress staticcheck SA5011 false positives in test files (#3715)2个月前
  • .goreleaser.yamlAdd Stable and Preview release channels / 新增 Stable 与 Preview 双发布渠道 (#6155)7天前
  • CHANGELOG.mdHarden dynamic Bash authorization without disrupting Auto / 加固动态 Bash 授权并保持 Auto 低干预 (#6985)5天前
  • CONTRIBUTING.mdfeat: support REASONIX_HOME for fully isolated runtime environments27天前
  • LICENSEchore: initialize v2 — ground-up rewrite2个月前
  • Makefiletest(desktop): add faster desktop test lane28天前
  • README.mdfeat(context): introduce Context Engine v2 / 引入上下文引擎 v2 (#7001)3天前
  • README.zh-CN.mdfeat(context): introduce Context Engine v2 / 引入上下文引擎 v2 (#7001)3天前
  • REASONIX.mdfeat(context): introduce Context Engine v2 / 引入上下文引擎 v2 (#7001)3天前
  • SECURITY.mdfix(control): contain image file references1个月前
  • devfix(desktop): apply pnpm purge guard so post-sync wails dev stops aborting (#4024)2个月前
  • go.modfix(cli): resolve colour support from colorprofile2天前
  • go.sumFix Remote Workbench release blockers / 修复远程工作台发版阻断 (#6790)10天前
  • prod_fast_testfeat: refine reasoning work process display22天前
  • prod_testfeat: refine reasoning work process display22天前
  • reasonix.example.tomlfeat: add regional CNY/USD pricing and English localization / 增加区域人民币/美元价格与英文国际化 (#6945)4天前
  • Reasonix

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

    npm version CI license downloads GitHub stars AtomGit stars contributors Discussions 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. External tools run as subprocesses over stdio JSON-RPC (MCP-compatible). Built-in tools self-register at compile time.
    • 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:

    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.

    Path B: Desktop app

    Use the official download page for the latest desktop build.

    Platform Package Architecture
    macOS Universal .dmg or .zip Apple Silicon / Intel
    Windows Installer .exe or portable .zip x64 / ARM64
    Linux .deb or .tar.gz x64

    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.

    Path D: Build from source

    git clone https://github.com/esengine/DeepSeek-Reasonix.git
    cd DeepSeek-Reasonix
    make build      # -> bin/reasonix(.exe)
    make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)

    Quick start

    CLI / TUI

    These commands are for the CLI/TUI installed through Path A:

    reasonix setup                      # configure a provider and model
    reasonix                            # start an interactive session
    reasonix run "implement the TODOs in main.go"

    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

    Star History

    Star History Chart

    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.

    Contributor Contributor Contributor Contributor
    SivanCola esengine ttmouse lifu963
    reasonix (anonymous) HUQIANTAO GTC2080 light-front-theory
    merge-order-check (anonymous) Li-Charles-One eghrhegpe wufengfan (anonymous)
    CVEngineer66 dependabot[bot] lanshi17 SuMuxi66
    CnsMaple cyq1017 JesonChou XTLine

    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


    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.

    WeChat Pay QR code

    邀请码
      Gitlink(确实开源)
    • 加入我们
    • 官网邮箱:gitlink@ccf.org.cn
    • QQ群
    • QQ群
    • 公众号
    • 公众号

    版权所有:中国计算机学会技术支持:开源发展技术委员会
    京ICP备13000930号-9 京公网安备 11010802047560号