VS Code 扩展不内置 CLI,需先安装 1.x CLI 才能启动 reasonix acp 后端;从源码构建 CLI 需 Go 1.25+ 并保持 GOTOOLCHAIN=auto,Studio 另需 Node 24+ 与 pnpm 10;使用前必须先通过 reasonix setup 或 Studio 配置模型服务商
DeepSeek-Reasonix
esengineMIT活跃维护基于 DeepSeek 的命令行编码智能体,专为复杂软件工程任务设计,能稳定完成代码编写与开发流程自动化。
A reliable coding agent for complex software engineering tasks.
npm i -g reasonix
reasonix setup
reasonixREADME 未说明显存或 GPU 要求;程序运行在本机,模型为外部服务,需自行配置 provider
开源终端/桌面 AI 编码代理,读代码改文件跑测试,模型自选
基于 DeepSeek 的命令行编码智能体,专为复杂软件工程任务设计,能稳定完成代码编写与开发流程自动化。
核心能力
- 读取项目代码、编辑文件并运行命令与测试
- 提供权限分级与 plan 模式,先审批再动手
- 改动前自动保存文件,可按对话轮次回滚
- 内置 DeepSeek 预设,兼容任意 OpenAI 接口
- CLI、Studio 桌面端、VS Code 扩展共用同一本地引擎
容易踩的坑
- v2.58.1Reasonix CLI v2.58.1最新正式版2026-11-09 · 2026-11-09 01:16 UTC
CLI archives built from the Studio release studio-v2.58.1.
- studio-v2.58.1Reasonix Studio v2.58.12026-11-09 · 2026-11-09 01:07 UTC
查看更新说明
本版是修复版:修好 2.58.0 里设置页版面错位、会话行置顶按钮常驻、模型菜单标签折行、思考「展开」被限高等问题,修复 Windows 启动闪控制台窗口、命令行
mcp --help误执行和 Linux 终端选择。变更
- 桌面壳的 Electron 升到 45.2.3(Chromium 156,含上游的安全与稳定性修复)。关联 #15027。
修复
- 修复 Linux 上「在终端中打开」不管你把哪个终端设成默认,总是按固定顺序挑一个(比如装了 konsole 就先用它,而不是你的 kitty)。现在如果装了
xdg-terminal-exec(桌面规范里读取默认终端的启动器),就由它按你机器声明的默认终端打开;没装的话仍按原来的顺序(#15031)。 - 修复命令行里
reasonix mcp import --help(以及mcp remove --help等其他子命令)不会显示用法,反而把--help当成参数真的去执行:import会直接改写 MCP 配置。现在所有reasonix mcp子命令的--help/-h都只打印用法并退出,什么都不改;mcp import带多余参数时会报错而不是照常导入(#15022)。 - 修复 2.58.0 里,开着「会话行快捷按钮」时,侧栏每一行会话都一直显示一个置顶图标(不管有没有置顶):现在这个按钮只在鼠标移上去或键盘聚焦时才出现;已置顶的会话在没悬停时会一直显示一个小图钉,方便一眼看出(#15012)。
- 修复输入框右下角的模型选单里,模型名字较长时,右边的「读图」标签被挤成两行竖着排的问题;现在标签始终在一行里完整显示(#15012)。
- 修复 2.58.0 里设置的「模型」「连接」等单栏页面:顶部「本页包含」目录和下面的标题、卡片没有对齐,卡片左边多出一大块空白(现在三者对齐到同一条左边线)(#15008)。
- 修复从「操作与性能」点开「导航入口」这类二级页时,顶部多出几条空白的横条;现在二级页里只显示它自己(#15009)。
- 修复设置里「思考过程」选成「展开」后,模型思考时仍然只显示最新六行、要等整段思考结束才一下子全部显示的问题:选「展开」时,运行中的思考块现在随内容一直完整展开;「进行中展开」仍是最新六行的滚动窗口(#15013)。
- 修复 Windows 上每次启动 Reasonix Studio 都会先闪一下黑色控制台窗口的问题:启动时用来确认"是不是同一个 Studio"的内核探测,以及启动内核本身,现在都隐藏控制台窗口(#15016)。
Changed
- The desktop shell moves to Electron 45.2.3 (Chromium 156, with upstream security and stability fixes). Refs #15027.
Fixed
- On Linux, "Open in terminal" picked a terminal by a fixed order rather than the one the machine declares as its default (konsole before kitty, for example). When
xdg-terminal-execis installed, it now starts the machine's default terminal; without it the old order still applies (#15031). reasonix mcp import --help(and--helpon the othermcpsubcommands) did not print usage and ran the command with--helpas an argument, soimportrewrote the MCP configuration. Everyreasonix mcpsubcommand now prints usage for--help/-hand changes nothing, andmcp importrefuses extra arguments instead of importing (#15022).- With "Quick buttons on session rows" turned on, every session row in the sidebar showed a pin icon all the time, pinned or not (2.58.0). The button now appears only when the pointer is over the row or it has keyboard focus, and a pinned session keeps a small pin on the row while nothing is hovered (#15012).
- In the model menu next to the message box, the "reads images" tag was squeezed into two stacked characters beside a long model name; it now stays whole on one line (#15012).
- In Settings, single-column pages such as Model and Connection no longer draw the "On this page" index out of line with the title and cards, which left a wide empty strip beside the cards in 2.58.0; all three now share one left edge (#15008).
- Opening a sub-page such as Navigation entries from Operation and performance no longer leaves a few empty bars above it; the sub-page shows only itself (#15009).
- With Thinking set to "Open", a thought still showed only its latest six lines while the model was thinking and then jumped to the full text when it finished. In "Open" the running thought now grows with its text; "Open while running" keeps the six-line rolling window (#15013).
- On Windows, launching Reasonix Studio no longer flashes a console window first: the kernel probe that tells whether this is the same Studio, and the kernel launch itself, now run with their console hidden (#15016).
What's Changed
- chore(deps-dev): bump electron from 45.1.0 to 45.2.3 in /desktop/electron in the npm group by @dependabot[bot] in https://github.com/esengine/DeepSeek-Reasonix/pull/15027
- chore(deps): bump the npm group in /desktop/frontend-next with 11 updates by @dependabot[bot] in https://github.com/esengine/DeepSeek-Reasonix/pull/15029
- chore(deps): bump the actions group with 4 updates by @dependabot[bot] in https://github.com/esengine/DeepSeek-Reasonix/pull/15028
- chore(deps): bump the go group with 3 updates by @dependabot[bot] in https://github.com/esengine/DeepSeek-Reasonix/pull/15025
Full Changelog: https://github.com/esengine/DeepSeek-Reasonix/
- v2.58.0Reasonix CLI v2.58.02026-11-07 · 2026-11-07 16:03 UTC
查看更新说明
CLI archives built from the Studio release studio-v2.58.0.
- studio-v2.58.0Reasonix Studio v2.58.02026-11-07 · 2026-11-07 15:54 UTC
查看更新说明
本版重新排版了手机端(标题栏、审批、输入区、模型菜单、设置),让设置更好找(搜索按相关度排序、每页有目录),并缩小了发给模型的工具定义、加快了启动和长会话的恢复与保存。
新增
- 记忆按「星系」归类,带重要度和遗忘曲线:常用的越记越牢,久不用的慢慢淡下去,仍能搜到(da640949c、bfc838a3c)。
- 约束类和每轮常驻的记忆永不变淡(c22dd9495)。
- 设置里的记忆页改成三栏:左边分类,中间带搜索的列表,右边详情,可改类型、星系、重要度(d0289a4d0)。
- 刚记住的记忆放在「新的」里,一键「对 / 忘掉」;忘掉是归档,不是删除(d0289a4d0)。
- 手机宽度(≤520px)重新排版:标题栏保留会话列表、居中的标题和机器状态;断线时说明正在重连(411e19d87)。
- 手机上的审批卡是两个等宽的大按钮,拒绝在左、允许在右,其余选项收在「更多选项」后面(411e19d87)。
- 手机上的输入区只留添加、模型和发送,其余控件收在一个「更多工具」按钮后面;运行中发送变成圆形暂停键(ae46c30d3)。
- 手机上的模型菜单改为贴底的面板;推理深度是一条品牌色的深度线,松手时才选定(e8b13d13d、8c71d355b)。
- 手机上的设置全屏、单列,分类变成顶部可滑动的一排,鼠标滚轮也能横向滑动(37ec85381、081f35e9d)。
- 设置搜索按相关度排序,可输入多个词或一整句;43 条常见说法(如「深色模式」「换模型」「关闭通知」)都排在前三,其中 23 条原来显示「没有匹配的设置」(4779d91c5)。
- 每个设置分类页顶部有「本页包含」目录,折进该页的设置也能一键跳到(4779d91c5)。
- 有新版本时,侧栏底部会出现「新版本 x.y.z 可用」按钮,点一下直接打开版本页;已下载待重启时也在这里提示(289033df0)。
- 更新方式默认改为「通知」:全新安装会在后台读取版本目录,发现新版本时提示,不下载也不安装;选过「手动」的会被保留(289033df0)。
变更
- 执行过程步骤超过 6 项时,更早的步骤合成一行,写明有几项、各是什么类型,点开能看全部;失败和运行中的步骤不会被折叠(42e8d2e5a)。
- 提问卡里的单行选项压到一行的正常高度,只有带说明的选项才会变高(ed18015c1)。
- 对话正文默认字号改为 14 像素(原来中文 13、英文 12.5),「正文字号」的四档也相应调整(c84e1682e)。
- 内置浏览器的空白页改成中文标题,并说明模型操作页面时页签上会有蓝点(0b21cafee)。
- 输入框里的「N 个文件已更改」移到右上角,和左上的运行徽标同一行(1a649b2ff)。
- 输入框下方的按钮和选择器统一成同一个高度(52534f832)。
- 运行中的输入框:停止键改成红色圆形,发送键一直在旁边,输入后变成「插话」或「排队发送」按钮(efdbf9788)。
- 运行中输入框提示「运行中也可以继续输入…」,模型按钮前显示厂商图标(efdbf9788)。
- 还没连接模型服务时,输入框上方的提示带警告图标,并说明「发不出去」(97c3ebbbf)。
- 上下文用到 80% 以上时,状态栏里的上下文读数和圆环变成橙色提醒,不弹窗(20903c347)。
- 上下文压缩只有一个自动触发点:输入到模型窗口的一定比例,新配置默认从 85% 改为 90%,已有配置保持原值(7e1cdccb8)。
- 工作台页签和文件列表里的文件图标按类型着色:代码、数据、图片各一种颜色,文档和未知类型保持灰色(df2ae9661)。
- 界面字体改成设计稿的字体栈:英文数字用 Inter,中文优先用系统字体(苹方、微软雅黑 UI),内置的 Inter Studio 和 Noto 作后备,中文笔画比之前更细(46dd272fc)。
- 最左边的图标栏默认不再显示,用量、文件、工具与权限、扩展、记忆、远程、反馈这些入口都在侧栏里;要图标栏可以在设置的「导航与侧栏」里打开,已经选过的保持原样(e461d4899)。
- 输入框下方的后台任务读数写明有几个在跑;没有在跑但有失败时变红并写明失败几个,否则显示已结束的总数(751974427)。
- 有两个以上后台任务在跑时,任务列表多了「全部停止」,点一次确认后才会全部停下(498d2af00)。
- 后台任务的用时写成「12 分 21 秒」,停止要再点一次「确定」,3 秒不点自动收回(11169ceb3)。
- 子代理统一为
spawn_agents,一次 1 到 8 个并行任务,子代理自带读文件、写文件、执行命令三件工具(ad2c96347)。 - 计划模式下子代理只读;完整输出归档,主模型先看开头和引用,再用
read_subagent_result读后面(ad2c96347)。 complete_step不再要求提交证据,计划步骤不再有验收和检查字段(5766a8ebe)。use_capability的说明不再提task:fleet,工具清单前缀因此变化一次(ad2c96347)。- 按钮统一成三种尺寸:小号 24px 胶囊、中号 32px 圆角、图标 28px 方形;各页面原来各不相同的高度和圆角都改成一致(3d6e532b0)。
- 设置里的输入框统一成一种样式:32px 高、7px 圆角、13px 字,聚焦和出错的光圈一致;模型逐行的价格和上限用 24px 小号(0e1dff5b5)。
- 下拉框统一成一种样式:32px 高、7px 圆角、细灰箭头贴右边,列表行里用 24px 小号;不再显示系统自带的粗箭头(e3e06303f)。
- 工作台的新标签页给每个入口加了一句说明,并加了标题(dddcf2b3d)。
- 底部状态读数里的缓存和本会话花费前加了图标,数值用正文色、标签用浅色(2db788599)。
- 输入框里的模型和推理强度合成一个按钮、一个面板:左边选模型,右边选这个模型的推理强度(5d560c287)。
- 按钮上推理强度只写一次中文,悬停显示完整的模型和档位(5d560c287)。
- 「移到另一个项目」对话框改成单选列表,并把「会带走」和「不会带走」分成两栏(38143faff)。
- 没有别的项目时可以直接在对话框里添加项目(38143faff)。
- 命令面板更宽(600),位置略靠上,背后是淡淡的压暗而不是模糊(0a8829fbb)。
- 命令面板打开时先列出「最近用过」,是你最近选过的三个操作或会话(2b6405327)。
- 命令面板可以用开头的
>#,只搜操作、会话或设置,Tab 切换范围;搜索时「最佳匹配」单独排最前,也能直接搜到设置并跳到对应位置(f46e8a274)。 - 等你批准的权限请求卡加了强调色描边,按钮行不再压在灰条和分隔线上(cbaaeb98f)。
- 批准、提问和扩展请求这几种需要你处理的卡片,头部统一显示强调色的「等你处理」标签,处理后变成「已处理」(c78941743)。
- 消息导航条的悬停卡片:数字和文字之间不再有空格,标题旁写明改了几个文件,下方提示点击跳转和右键加星标(d7e6e0129)。
- 消息导航条里,改过文件的消息横线更长,一眼能和普通消息分开(b14f1ea82)。
- 侧栏的会话行和项目行改成与设计稿同一份样式:行高 30、悬停时时间换成「···」菜单、置顶图钉放在标题右侧(8e203505d、9c4393d30)。
- 界面英文和数字改用内置的 Inter 字体,字重也不再全部变成最粗(b4c548b1a)。
- 排队消息上的「立即发送」改成设计稿里的 24px 胶囊按钮(ff34193a5)。
- 「最近的会话」按「今天」「更早」分组,搜索框带图标,运行环境收成紧凑的选择框(d0f2be43a)。
- 「最近的会话」里正在运行或等你确认的会话会写出状态,并可以用上下方向键选、回车打开(c97d7b6af)。
- 批量选择会话时,操作条固定在会话列表底部,按钮统一成小号(5b51c0128)。
- 侧栏的会话筛选改成一个下拉,每项带数量,新增「等你处理」「未读」两个筛选,选中后旁边有一键清除(8b1218dd4)。
- 会话行上给 1.x 创建的会话加的「旧」小标签去掉了,和设计稿一致(一行最多一个标签)(8b8ca3605)。
- 会话右键菜单按用途分成五组,导出合成一项并可选 Markdown 或 JSON(738182072)。
- 会话在运行时先给「暂停执行」,不能关闭或移动的原因直接写在菜单项下面(738182072)。
- 会话列表里,运行中的会话行右侧写「运行中」,等你处理的写「等你确认」,代替时间(a0ce00b5f)。
- 侧栏的会话行和项目行改成设计稿的尺寸:行高 30、会话标题 13 号字,本地项目前面加了折叠箭头(a51e00325)。
- 侧栏会话行按设计稿:左边一个状态圆点(蓝=运行中,橙=等你确认,黑=未读),右边一个状态词或时间;时间写成「刚刚、N 分钟、N 小时、昨天、月-日」;去掉原来的竖条、微光、闪烁和阴影,会话行不再往里缩进(962da251e)。
- 在会话列表里搜索时,每个标题里命中的部分会高亮(aebed7fb5)。
- 会话行右边那个「+1」小胶囊去掉了,设计稿里一行最多一个标签;有早先版本或恢复副本的会话,在它的「···」菜单里多一项「早先版本(N)」,点开在会话下面原地展开,缩进一层的灰色小字(d23cfeb21)。
- desktop-v1.39.11Reasonix Desktop v1.39.112026-11-02 · 2026-11-02 09:43 UTC
查看更新说明
安全修复:python3 -v 脚本 不再被当成只读的版本探针,和其他会运行代码的命令一样需要先批准。
发布渠道:稳定版 · v1.39.11
概览
Reasonix v1.39.11 — Reasonix 1.39.11
安全修复:python3 -v 脚本 不再被当成只读的版本探针,和其他会运行代码的命令一样需要先批准。
发布日期:2026-11-02
Desktop 1 · CLI 1
桌面端更新
重点内容
- [Desktop · CLI] python -v 不再被当作只读的版本探针 — Python 里 -v 是显示模块导入过程,不是版本参数,所以 python3 -v 脚本 会运行这个脚本。Reasonix 过去把它当作只读命令,在「询问」模式和只读模式下都不经询问就直接运行。现在 python、python3 只有 --version 和 -V 这两种精确写法算只读,其余都需要批准。从不可信文件夹打开的仓库,不能再借此不经提示地运行它自带的脚本。详见 GHSA-qrrg-f72x-hx7r。 (#14928 by @esengine)
CLI 端更新
重点内容
- [Desktop · CLI] python -v 不再被当作只读的版本探针 — Python 里 -v 是显示模块导入过程,不是版本参数,所以 python3 -v 脚本 会运行这个脚本。Reasonix 过去把它当作只读命令,在「询问」模式和只读模式下都不经询问就直接运行。现在 python、python3 只有 --version 和 -V 这两种精确写法算只读,其余都需要批准。从不可信文件夹打开的仓库,不能再借此不经提示地运行它自带的脚本。详见 GHSA-qrrg-f72x-hx7r。 (#14928 by @esengine)
升级提醒
本版本无需手动迁移。
风险提示
当前没有需要额外操作的已知风险。
下载与安装
贡献者
感谢本版本的贡献者:@esengine
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
[!IMPORTANT] Community · 加入社区 — bilingual Discord for setup help (
#help/#求助), workflow showcases, and feature ideas. → https://discord.gg/XF78rEME2DQQ group DeepSeek-Reasonix官方群 (
1093562660) → https://qm.qq.com/q/i59b0z2R8s (QR code)
Douyin: 做游戏的小鱼 (Douyin ID
22703872788) · QR code
❤️Sponsor
What it is
Reasonix is an open-source AI coding assistant. The program runs on your computer; the AI model is a service you configure, which receives what it reads. You describe a task in plain language; it reads code, edits files and runs commands and tests inside the project folder you choose, and shows you each step.
You pick the model: a DeepSeek preset is built in, any OpenAI-compatible service is one config entry, and you pay the model provider directly.
What you get
- Read, edit, run. It reads code, edits files and runs tests and commands, all inside your project folder.
- Permission levels. Have it ask every time, or let everyday actions run on their own; your forbid rules always hold. To see the approach first, use plan mode: it starts work only once you approve.
- Rewind. A file is saved before it changes, so you can rewind by conversation turn without touching your git history. Only files its edit tools changed are covered, not what a shell command did.
30-second start
Download, add a model key, open a project. New here? Start with the Studio desktop app.
- Download and install the desktop app, Reasonix Studio, from the releases page.
- Open it and enter your model provider and key when asked.
- Open your project folder and write what you want, for example "add retry on failure to the http client".
- At the level you chose, it stops and asks before anything that needs your say-so. Allow it to continue, or refuse.
Prefer a terminal? Download the reasonix command-line tool, run reasonix setup to pick a model, then run reasonix. See Install and Quick start.
Four ways to use it
- Desktop app (Studio). A graphical app; the best place to start.
- Terminal. A full-screen text interface;
reasonix run "task"also works in scripts. - Browser.
reasonix webopens a web interface on your own machine. - Editor. Install the extension in VS Code; other editors that support ACP (Agent Client Protocol, a common way for an editor to connect to an AI assistant) can connect to
reasonix acp.
All four are the same program underneath. What follows is for advanced users and contributors.
Use it from DeepSeek Harness
DeepSeek Harness (dsh) can hand a task to Reasonix as a subagent over ACP. This repository publishes a plugin index for it:
- Run
reasonix setupon the machine that runsdsh. In the DSH Web UI turn on Custom plugin markets (Plugins, More) and add this index in the Discover tab:https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/studio/integrations/dsh-plugin/market-index.json - Install "Reasonix subagent" from it.
- Open the plugin's page and turn its switch on. While it is off the model has no
reasonixtool and may runreasonix -pin its own shell, which looks like a delegation and is not one.
Setup details, the permission policy and limits are in Using Reasonix from DeepSeek Harness.
Versions
Reasonix ships on two lines. See the version roadmap announcement for the reasoning behind the split.
| Line | Branch | Status | Get it |
|---|---|---|---|
| Reasonix 2.x | studio (this branch) | Active development | Studio releases |
| Reasonix 1.x | main-v2 | Maintenance / stable | npm i -g reasonix · desktop download |
- Want something stable? Stay on 1.x. It keeps receiving bug fixes, provider/API compatibility, updater and security fixes; its core architecture is no longer being extended.
- Want the new architecture? Use 2.x Reasonix Studio. It is still moving quickly; reports are welcome.
Valuable fixes, tests and behaviour from 1.x are reviewed one by one and ported or reimplemented on 2.x where they fit the new architecture.
- Moving from 1.x to 2.x: what the two lines share, and how to run both on one machine without losing sessions.
- 2.x roadmap: what 2.x still has to deliver, how it ships, and the decisions still open.
Features
Technical highlights for advanced users.
- 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. MCP servers contribute tools, prompts, and resources; Extension Protocol v1 sidecars can also intercept runtime events, contribute Providers and structured UI, and ship versioned plugin packages.
- 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=0single binary; cross-compile to six targets with one command. The result is a fully self-contained static binary — nothing to install on the target machine beyond the binary itself.
Install
This branch is Reasonix 2.x. Its desktop app is Reasonix Studio; the CLI, Studio, and editor integrations all run the same local Reasonix engine.
Reasonix Studio (2.x)
Download the package for your platform from the latest
Studio release
(tagged studio-v2.*; candidates such as -rc.N are marked as
pre-releases):
| Platform | Package | Architecture |
|---|---|---|
| macOS | .dmg or .zip | Apple Silicon (arm64) / Intel (amd64) |
| Windows | Installer -installer.exe or portable .zip | x64 |
| Linux | .deb, .rpm, or .AppImage (download only) | x64 (amd64) / ARM64 (arm64, aarch64) |
Every package ships with a .minisig signature, and the release carries
SHA256SUMS. Once installed, Studio updates itself in place.
The same release also carries the 2.x reasonix CLI as archives for
darwin|linux|windows × amd64|arm64.
The Android build ships on that release as ReasonixMobile-<version>.apk
(arm64, Android 8.0 or newer). The kernel and the page run on the phone, and
the agent reaches your servers over SSH; pairing with a computer is done by
scanning the code it shows.
The APK is signed with the Android release key rather than minisign, so it
carries a .sha256 and no .minisig.
When that key is absent the build is named
ReasonixMobile-<version>-unsigned.apk. Android refuses to install an unsigned
package, so those builds stay a workflow artifact for whoever wants to sign one,
and the release carries no APK at all.
Reasonix 1.x (stable)
The 1.x CLI installs through npm on any supported platform, or Homebrew on macOS:
npm i -g reasonix # any OS; pulls the prebuilt native binary
brew install esengine/reasonix/reasonix # macOS
The 1.x desktop app is on the official download page. Windows installers are code-signed with a Certum code-signing certificate.
VS Code extension
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. Install the 1.x CLI first.
- VS Code: install from Visual Studio Marketplace
- VSCodium / Eclipse Theia: install from Open VSX Registry
- Extension ID:
SivanLiu.reasonix-agent· source and usage guide
Build from source
Clone the repository; studio builds 2.x and main-v2 builds 1.x:
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
git switch studio
CLI
The CLI build requires Go 1.25+. The module pins a toolchain directive;
keep GOTOOLCHAIN=auto so Go downloads the pinned toolchain, or install it.
make build # -> bin/reasonix(.exe)
make cross # -> dist/ (darwin|linux|windows × amd64|arm64)
Studio
Studio additionally requires Node 24+ and pnpm 10
(npm install -g pnpm@10) for the frontend.
make studio
See the Studio build guide for platform webview dependencies and Linux build tags.
Quick start
Reasonix Studio
Install and launch Studio, then connect a provider and model in the app. No CLI setup is needed.
CLI / TUI
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.
For advanced CLI usage and configuration, see the CLI reference, Guide, and configuration paths.
Documentation
- Getting started: Guide · CLI reference · Configuration paths · ACP editor integration · Use from DeepSeek Harness
- Features & troubleshooting: Subagent profiles · Context Engine v2 · Capability diagnostics · Recovery and updates · Checkpoints & rewind
- Agent presets: Session Agent compositions
- Engineering & migration: Spec · Task contracts & pause policy · Tool contract · Moving from 1.x to 2.x · 2.x roadmap
- Extension development: Skills · Extensions · Plugin packages and Manifest v1 · Extension Protocol · Go SDK and starter
Star History
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 | KHG420 | ttmouse | chuiwenwei |
| lifu963 | XTLine | HUQIANTAO | xxoingr |
| Harbor404 | GTC2080 | mchenziyi | Li-Charles-One |
| light-front-theory | imcreazy | eghrhegpe | noreply |
| par73e | Bernardxu123 | lancy69 | Guan0923 |
Special thanks to Bernardxu123 for designing the project logo and intro video.
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
- 国内 — 微信支付 / 支付宝(扫码)