RSI Boot MCP server

<!-- mcp-name: io.github.Apollo-lwx/rsi-boot -->

RSI Boot

简体中文 | English

Agent 记忆很多人都在做。RSI Boot 要解决的是另外两件事：harness 会跟着用、跟着改，以及记忆跟着仓库走、换宿主不重学。

主链路零 API Key，不调用模型。约定、禁止项、修复经验和 harness 槽位都只落在当前仓库的 .rsi/，下次任务前按需召回。

和「又一个记忆插件」差在哪

rsi-harness（Harness-RSI） 负反馈进失败桶，只改可写槽位（提示词 / 技能 / 召回策略 / 意图规则 / 知识）。提案过静态门禁和人工确认才晋升，观察 7 天，采纳率掉就回滚。越用越会干活，不是越记越多。

跟随项目迁移 记忆按仓库隔离，不跟账号、不跟 IDE。仓库拷走、换机器、换目录，.rsi/ 一起走；打开另一个仓库就是另一份，不会串。Harness 基因组可导出 bundle，跨项目备份或迁槽位。

多平台兼容 同一套 MCP（rsi serve）接 Cursor、Qoder、Codex；状态栏同时吃 Claude Code 与 Cursor CLI。规则注入走 .cursor/rules 和各宿主都认的 AGENTS.md 托管块，换工具不用把项目史再讲一遍。

安装

需要 Python 3.10+：

pip install rsi-boot
rsi init

要改源码则克隆本仓库，按开发一节用可编辑安装。

rsi init 只写用户配置 ~/.rsi/config.yaml。项目记忆在各仓库的 .rsi/，第一次启动 MCP 或 bootstrap 时创建。

接到 Cursor

在要用记忆的那个项目的 .cursor/mcp.json 加：

{
  "mcpServers": {
    "rsi-boot": {
      "command": "rsi",
      "args": ["serve"],
      "env": {
        "RSI_PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

然后 Settings → MCP 确认 rsi-boot 已启用。改过本仓库代码后要重载该 MCP。

不要配用户级 mcp.json：那里 args 里的 ${workspaceFolder} 经常不展开，会把记忆串到别的仓库。工作区绑定顺序：RSIPROJECTROOT（项目级 mcp.json，推荐，显式契约）→ MCP roots/list（插件形态下由 Cursor 自动应答）→ Cursor 注入的 WORKSPACEFOLDERPATHS → 进程 cwd。

接到其他宿主

Claude Code

插件市场方式（推荐，可随仓库更新）：

/plugin marketplace add Apollo-lwx/rsi-boot
/plugin install rsi-boot@rsi-boot

或一条命令直接装 MCP：

claude mcp add rsi-boot -- uvx --from rsi-boot rsi serve

工作区按 roots/cwd 自动认领。状态栏集成见下文「状态栏（可选）」。

Qoder

本仓库同时是 Qoder 插件：.qoder-plugin/plugin.json 清单 + 根目录 mcp.json（与 Cursor 插件共用同一份 MCP 配置），打 zip 即可分发。手动接的话二选一：

qoder mcp add rsi-boot -- rsi serve

或在项目根 .mcp.json 加与 Cursor 相同的 mcpServers 片段。工作区绑定顺序与 Cursor 一致（RSIPROJECTROOT → roots/list → 注入变量 → cwd）。

Codex

一行命令接入（推荐）：

codex mcp add rsi-boot -- uvx --from rsi-boot rsi serve

或手写 TOML 配置：用户级 ~/.codex/config.toml，或项目级 .codex/config.toml（需目录已被信任）：

[mcp_servers.rsi-boot]
command = "rsi"
args = ["serve"]

从项目根目录启动 codex 即可——MCP 子进程继承 cwd，rsi-boot 按 cwd 向上认领工作区。要显式钉死就在表里加一行：env = { RSIPROJECTROOT = "/绝对/路径" }。

状态栏（可选）

rsi statusline 给宿主 CLI 渲染底部状态栏：模型、上下文余量、token 统计（in/out/cache）、花费、RSI 今日召回与采纳率，外加一条定期轮换的随机文案。Claude Code 与 Cursor CLI 通用（两家的 statusLine 都会把会话 JSON 从 stdin 喂进来，本命令解析后单行输出，带 ANSI 颜色与 emoji）。

Claude Code（~/.claude/settings.json）：

{
  "statusLine": { "type": "command", "command": "rsi statusline" }
}

Cursor CLI（~/.cursor/cli-config.json）：

{
  "statusLine": { "type": "command", "command": "rsi statusline" }
}

效果示例：

🧠 Kimi K3 │ 📊 上下文余 71% │ ⛽ in 12.3k · out 1.8k · cache 96k │ 💰 $0.42 │ 🐾 RSI 召回 3 · 采纳 92% │ 给你比个心❤

选文案风格

三种配法并列，按场景任选（优先级：--style > 环境变量 > 项目级 > 用户级）：

// ① 跟着宿主走：直接写进 statusLine 的 command（最直观，不动任何 config.yaml）
{ "statusLine": { "type": "command", "command": "rsi statusline --style buddy" } }

# ② 项目级（按仓库定风格，跨宿主共享）：<工作区>/.rsi/config.yaml

Shortened. The full README is on GitHub.