ThinkRail 是一款具备进化能力的智能体 IDE。它围绕 pi 编码智能体构建，通过“活体规范”（living specs）学习项目上下文，并在独立工作区中赋予智能体持久的项目知识。该工具旨在根据开发者的实际工作流动态创建所需工具，目前支持完整的扩展体系。
核心特性
隔离式工作区管理
ThinkRail 将 Git 仓库切割为独立的 git worktree 工作区，每个工作区拥有独立分支和目录。智能体可并行工作而不干扰主分支，优秀成果可合并，其余部分可删除。工作区状态会自动沉淀，支持一键发布 PR、查看 CI 状态及处理代码审查。顶部栏实时显示分支相对于 origin 的状态。
原生 IDE 体验
提供可分割的工作台，集成 Monaco 编辑器、实时 Git 标记文件树、终端及文档视图。所有操作限定在活动工作区内，支持在文件差异上留下锚定评论并作为结构化上下文发送至聊天窗口，或直接在外挂 IDE 中打开 worktree。
流式聊天与多会话
每个工作区支持多个并发 pi 会话，各自拥有独立模型、Token 及成本读数。用户可引导当前回合、排队后续任务或委托子智能体执行。共享计划随智能体更新而协作演进，每一步骤均可单独提交和审查。
规范即事实标准
通过 SPEC.md 文件连接图与代码并存。智能体利用专用 spec_* 工具读取和维护规范，确保意图跨会话保留。只读 Specs 工具以树形结构在工作台中渲染规范图。
MCP 服务器与扩展
支持连接 mcp.json 中的 MCP 服务器，调用前需在聊天中确认（除非标记为只读或已信任）。支持 OAuth 登录，并在聊天侧边栏显示后台命令及对应服务器。此外，还提供 Web 研究、内联图表渲染及 UI 更改前后模拟图预览功能。
无账户体系与多端支持
ThinkRail 不设立自有账户体系，支持通过 JetBrains AI 登录或绑定任意提供商凭证。提供原生桌面应用及 thinkrail CLI，两者嵌入相同引擎主机，状态存储于 ~/.thinkrail。内置英文和简体中文，支持通过本地 JSON 文件扩展语言包。
安装与平台支持
ThinkRail 提供原生桌面安装程序和自包含 CLI 两种形式，发布页面均附带 SHA256SUMS 供验证。
- 桌面版：macOS (Apple Silicon) 提供 DMG；Windows x64 提供解压即用的安装 ZIP；Linux x64/ARM64 需 glibc 2.38+ 及 GTK 3 等依赖（推荐 Ubuntu 24.04+）。桌面版支持后台检查更新，用户需手动确认“安装 & 重启”。
- 命令行 (CLI)：支持 macOS、Linux 及 Windows (Git Bash/PowerShell)。安装脚本会自动下载二进制文件、验证校验和并配置 PATH。CLI 运行需系统安装
git及模型提供商凭证。
JetBrains 对 Windows CLI、桌面安装程序及相关 DLL 进行了签名。macOS CLI 已签名但未公证，Linux 工件未签名。
底层架构与开发
ThinkRail 采用轻量级主机架构，进程内运行 pi 并桥接至 Web UI。架构分为三层：
- 引擎主机：基于
Bun.serve的 HTTP+WS 服务，每个聊天对应一个进程内pi会话。 - 通信协议：主机与 UI 间类型化、版本化的契约接口。
- UI 客户端：基于 React 19 + Zustand + Tailwind v4 构建，独立分发并通过协议连接主机。
项目遵循规范优先开发模式，模块旁附带 SPEC.md，任何边界或契约变更需同步更新规范。开发环境需 Bun 1.4.4 及 Node.js ≥ 22.19。
隐私与许可
ThinkRail 仅收集基本使用事件（如启动、聊天创建）及匿名错误报告，关联随机生成的安装 ID。分析数据不包含提示词、代码、文件或凭证。额外产品使用数据需用户在设置中显式开启。项目基于 Apache License 2.0 开源许可。