DeepSeek-native · built for your terminal · MITDeepSeek 原生 · 为终端而生 · MIT

A DeepSeek-native agent
for your terminal.
DeepSeek 原生的
终端编码 Agent

The loop is append-only, aligned to DeepSeek's byte-stable prefix cache — so long sessions hold 90%+ cache hit and input-token cost collapses to ~1/5. Use the same engine from the CLI/TUI, desktop app, local browser UI, or an ACP-compatible editor.运行循环 append-only,对齐 DeepSeek 字节稳定的 prefix-cache —— 长会话缓存命中 90%+,输入 token 成本降到 约 1/5。CLI/TUI、桌面端、本地浏览器 UI 和兼容 ACP 的编辑器共用同一引擎。

Desktop app桌面端Visual workspace for sessions, settings, approvals, and updates.可视化管理会话、设置、审批与自动更新。Download desktop下载桌面版
CLI / TUICLI / TUITerminal-native agent with the same local Reasonix engine.终端原生入口,使用同一套本地 Reasonix 引擎。$npm i -g reasonix
fig. 01 — a live session, cache still warm图 01 —— 一场实时会话,缓存依然温热
~/app — reasonix
reasonix v1.1.0 · deepseek-v4-flash · ~/app add retry with backoff to the http client edit internal/net/client.go +24 −3 edit internal/net/client_test.go +41 −0 run go test ./internal/net/ ok (0.21s) 2 files · cache 94.2% → 95.1%
cache 95.1% hitsession 18mmodel deepseek-v4-flashcost $0.043
Features特性

Built for long, cheap sessions.为长会话、低成本而生。

Most agents pay full price for the same growing prompt every turn. Reasonix keeps the prefix byte-identical so DeepSeek's cache does the heavy lifting — and everything else follows.多数 agent 每回合都为同一段不断增长的 prompt 付全价。Reasonix 让前缀逐字节稳定,让 DeepSeek 的缓存替你扛下来——其余一切由此而来。

01 / cache-first

Cache-first loop缓存优先循环

Append-only history aligned to DeepSeek's prefix cache. 90%+ hit on long sessions; input tokens bill at ~1/5.append-only 历史对齐 DeepSeek prefix-cache。长会话 90%+ 命中,输入 token 约 1/5 计费。

02 / single binary

Single Go binary单个 Go 二进制

CGO-free, cross-compiled for darwin/linux/windows × amd64/arm64. No Node runtime to install or babysit.无 CGO,交叉编译覆盖 darwin/linux/windows × amd64/arm64。运行不需要 Node。

03 / mcp

MCP first-class

stdio, SSE, streamable HTTP. External servers merge their tools into one registry under a prefix.stdio、SSE、streamable HTTP。外部服务器的工具以前缀合并进同一 registry。

04 / plan + sandbox

Plan mode & sandbox计划模式 + 沙箱

/plan asks the model to plan first; Permissions and the workspace sandbox still govern every tool call./plan 要求模型先规划;每次工具调用仍由权限与工作区沙箱控制。

$ /plan → plan first · permissions still apply
05 / subagents

Subagents & skills子智能体与技能

explore / research / review / security-review agents, plus Markdown skill scripts with isolated tools.explore / research / review / security-review 子智能体,加 Markdown 技能脚本与隔离工具。

06 / cli + web + acp

Terminal, browser, or editor终端、浏览器或编辑器

Use the full-screen TUI, run reasonix serve for a local browser UI, install the Reasonix VS Code extension, or connect another ACP-compatible editor through reasonix acp. Every surface uses the same local engine.使用全屏 TUI、通过 reasonix serve 打开本地浏览器 UI、安装 Reasonix VS Code 扩展,或通过 reasonix acp 连接其他兼容 ACP 的编辑器;所有入口都使用同一套本地引擎。

$ reasonix acp
How it works工作原理

Every turn reuses the last.每一轮都复用上一轮。

Each request replays the exact same byte-for-byte prefix, so the model only computes what's new. Long sessions get cheaper per turn — not more expensive.每次请求都逐字节重放完全相同的前缀,模型只计算新增部分。会话越长,每轮越便宜——而不是越贵。

01Cold start — everything is computed冷启动——全部需要计算02The previous turn replays from cache上一轮全部从缓存重放03Only the new request is computed只计算新增的请求0490%+ cache hit — cheaper every turn命中 90%+——越跑越便宜
turn 1
turn 2
turn 3
turn 4
new tokens — computed新 token——需要计算cached prefix — replayed, billed at ~1/5缓存前缀——重放,约 1/5 计费
01

Install安装

One command. macOS, Linux, Windows, and WSL.一条命令,支持 macOS、Linux、Windows 与 WSL。

npm i -g reasonix
02

Point it at a repo指向你的仓库

Reasonix maps the codebase once, then keeps that map in the warm prefix.Reasonix 只做一次代码库测绘,然后把这份地图常驻在温热的前缀缓存里。

cd your-project && reasonix
03

Open the web UI打开 Web UI

Keep it local, or add token/password auth before sharing a tunnel or remote port.本机使用保持默认;通过 tunnel 或远程端口分享前,先启用 token/password 认证。

reasonix serve --auth token
04

Leave it running让它一直跑着

Queue tasks, review diffs, resume anytime. The session never goes cold.排任务、看 diff、随时恢复。会话永不冷却。

› refactor the auth flow
Community社区共建

Built in the open, with 94 contributors.开源共建,感谢 94 位贡献者。

Reasonix is MIT-licensed and developed in public. Every issue, every PR, every late-night review made it what it is — thank you.Reasonix 采用 MIT 许可,开放开发。每一个 issue、每一条 PR、每一次深夜 review,成就了今天的它——谢谢你们。

27,736 stars · 2,715 merged PRs · every avatar above is a real contributor27,736 stars · 2,715 个已合并 PR · 上面每个头像都是一位真实贡献者

Start a session that lasts.开启一场不会中断的会话。

Open source under MIT. Bring your own DeepSeek API key — your code never leaves your machine and the model.MIT 开源。使用你自己的 DeepSeek API Key——代码不会离开你的机器与模型。

macOS

Universal DMG · Apple Silicon & Intel通用 DMG · Apple Silicon 与 IntelDownload Universal · v1.1.0下载通用版 · v1.1.0

Windows

Installer · Windows 10+ · x64 / ARM64安装器 · Windows 10+ · x64 / ARM64Download · v1.1.0下载 · v1.1.0

Linux

Debian / Ubuntu package · amd64Debian / Ubuntu 安装包 · amd64Download .deb · v1.1.0下载 .deb · v1.1.0
v1.1.0 · built-in auto-updates · same engine as the CLI · all releases →v1.1.0 · 内置自动更新 · 与 CLI 同一引擎 · 全部版本 →
macOS opens with a quarantine warning?macOS 提示无法打开或已损坏?If the app was installed from the official download and placed in /Applications, quit Reasonix, then run:如果来自官网下载并已放入 /Applications,先退出 Reasonix,再运行:sudo xattr -rd com.apple.quarantine /Applications/Reasonix.appWhen to use this →查看适用场景 →
recommended推荐

Visual Studio Marketplace

For Microsoft Visual Studio Code适用于微软 Visual Studio CodeInstall extension安装扩展

Open VSX Registry

For VSCodium, Eclipse Theia, and compatible editors适用于 VSCodium、Eclipse Theia 及兼容编辑器Install from Open VSX从 Open VSX 安装
Extension ID SivanLiu.reasonix-agent · requires Reasonix 1.0+ installed and configured locally · the extension connects to reasonix acp and does not bundle the CLI · source code →扩展 ID SivanLiu.reasonix-agent · 需要先在本机安装并配置 Reasonix 1.0+ · 扩展连接 reasonix acp,不内置 CLI · 查看源码 →
$npm i -g reasonix
npm i -g reasonixv1.1.0Stable 1.x · one binary · no Node · actively developed稳定 1.x · 单二进制 · 无需 Node · 主力开发中recommended推荐
npm i -g [email protected]v0.53.2deprecated 0.x line · no longer maintained已废弃的 0.x 线 · 不再维护deprecated已废弃
macOS / Linux / Windows / WSL · npm latest tracks the current 1.x stable · v1.1.0 release notes →macOS / Linux / Windows / WSL · npm latest 指向当前 1.x 稳定版 · v1.1.0 更新说明 →
$brew install esengine/reasonix/reasonix
v1.1.0 (Go rewrite) · macOS & Linux · update with brew upgradev1.1.0(Go 重写)· macOS 与 Linux · 通过 brew upgrade 更新