ThinkRail 快速开始：10 分钟装好 pi 智能体 IDE，完成第一次可审查的代码协作

ThinkRail 快速开始：10 分钟装好 pi 智能体 IDE，完成第一次可审查的代码协作

【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail

让 AI 写代码容易，难的是审查它写了什么。ThinkRail 是围绕picoding agent 构建的智能体 IDE（agentic IDE）——AI 对话、代码编辑器、Git 变更审查集中在同一块工作台里，Agent 的每次改动都以 diff 形式摊开在你面前。读完本文并动手后，你会完成安装、打开一个 Git 仓库，并让 Agent 改出一处你能逐行审过的小变更。

🔍 ThinkRail 是什么：建在 pi 之上的 IDE

先说它是什么：ThinkRail 是一个"薄宿主"——它在进程内运行pi引擎，再把引擎桥接到一个功能完整的 Web 工作台。模型、技能、压缩、费用、会话状态全部归pi管；应用只管工作区、编辑器和两者之间的连线，从不在你背后偷偷组装 prompt。

对你来说，它意味着三件事：

• 工作区隔离：每个 Git 仓库可以切出多个 workspace，底层是git worktree，各自有独立分支和工作目录。就像给仓库拍一份带分支的"分身"，多个 Agent 并行干活时互不踩踏，主分支在你合并前保持干净
• Agent 周围是真 IDE：可递归拆分的 Monaco 编辑器、带实时 git 变更标记的文件树、终端、Diff 审查，全部锚定在当前工作区。你可以把锚定在某一行的 review 评论作为结构化上下文发回聊天
• Specs 即事实来源：仓库里层级化的SPEC.md构成一张规格图，Agent 通过专用spec_*工具读、搜、维护它，项目意图不再随会话蒸发

一个pi会话与它产生的变更，被圈定在隔离的 git worktree 工作区里——这就是 ThinkRail 的日常形态。

📥 选择适合你的安装方式：桌面包或一行命令

ThinkRail 提供两种安装形态：原生桌面应用和自包含的thinkrail命令行工具，两者内嵌同一个引擎，共享同一份状态。

前置条件先备好：git 与模型 provider

⚠️thinkrail要求系统 PATH 中已有git，并且至少有一个可用模型 provider——可以在应用里登录 JetBrains AI，或通过pi自带的 auth 连接你自己的 provider。ThinkRail 本身没有任何账号体系。

没有现成仓库也没关系：首次启动向导会引导你连接 provider 并挑选项目，点Start a new project还能在~/thinkrail下直接创建一个空 Git 仓库。

桌面版安装步骤

从官方 releases 页下载对应平台的thinkrail-desktop-*安装包：

⚠️ Linux 桌面版需要 glibc 2.38+、GTK 3、WebKitGTK 4.1、Ayatana AppIndicator 3 和 librsvg 2，Ubuntu 24.04 及以上开箱满足；更早的版本可先装依赖：

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2

装上依赖后解压 tarball 并运行installer，预期结果是桌面应用启动并进入首次启动向导。打包版桌面构建会在Settings → Updates里检查更新，流程是Download → Preparing update → Install & Restart，在你点 Install & Restart 之前什么都不会被应用。

CLI 一行命令安装

macOS / Linux（Windows 下的 Git Bash 也可以）执行：

curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash

安装脚本会自动下载对应平台的二进制、校验 SHA-256 并把thinkrail加入 PATH（脚本源码见 install.sh）。Windows 则在 cmd 或 PowerShell 执行：

powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"

Windows 的选项通过环境变量传递（THINKRAIL_CHANNEL、THINKRAIL_VERSION等），脚本见 install.ps1。装完验证一下：

thinkrail --version

预期结果是打印出当前构建版本号。脚本支持--channel stable|nightly和--version参数来固定渠道或版本，默认装到~/.local/bin/thinkrail。

⚠️ 如果安装结束时打印了 "Add to PATH" 提示，说明 PATH 还没生效——开一个新终端（或source你的 rc 文件）再运行thinkrail。

直接打开仓库

装好后带上仓库路径即可启动，预期结果是浏览器自动打开应用并加载该项目：

thinkrail ~/code/my-repo

不带参数运行thinkrail则会打开空工作台，让你在 Projects 面板里手动添加。

🏗 三条命令跑起本地开发环境

想参与开发或体验最新 nightly，从源码运行只需三条命令。前置条件：Bun1.4.4（仓库锁定的包管理器与运行时）、Node.js≥ 22.19（进程内pi引擎需要）、一个已认证的piprovider。

git clone https://gitcode.com/GitHub_Trending/th/thinkrail cd thinkrail bun install bun run dev

bun run dev会同时拉起 engine host（packages/server/）和 Web 客户端（apps/web/），预期结果是终端出现host ready与访问地址；Ctrl+C会停止两边。源码运行时项目、工作区、worktree 的状态统一存放在~/.thinkrail。另有几个常用入口：

bun run --filter @thinkrail/cli dev # 只起浏览器启动器 bun run build:binary # 构建独立 CLI 产物 bun run desktop:dev # 打包并打开 Electrobun 桌面应用

更多检查与测试流程见 CONTRIBUTING.md。

🗂 打开你的仓库：workspace 就是独立的 git worktree

启动后，在左侧 Projects 面板点+添加你的 Git 仓库，它就成为一个project。每个 project 自带一个Default workspace，就是仓库主工作树本身。

打开项目后进入 Default 工作区，对话、变更和终端都直接运行在项目目录中。

两种用法值得分清：

• Default workspace：AI 的改动直接落在项目目录，适合"就地干活"。对陌生代码库，建议先用隔离工作区。
• 新建隔离 workspace：自动创建git worktree，独立分支、独立目录，Agent 改崩了也不影响你的主分支；合并好分支后删掉其余工作区即可。已有的 worktree 也可以直接 attach 进来。

生命周期是自动的：完成或休眠的工作区会自动"沉淀"到项目级的Settled shelf——触发条件是 PR 合并或关闭、或安静满一周——需要时点一下就回来。顶栏实时显示当前分支相对origin与其 PR 的状态，下一步操作（publish、push、open PR）一键可达；PR 打开后还能看 CI 检查与审查结论。

🚀 第一次实战：让 Agent 做一个小改动并审掉它

第一次协作建议从低风险任务开始。假设你刚把 ThinkRail 仓库本身打开成项目，可以给它派这样一句活："给 CLI 的--help输出补一个用法示例"。完整走一遍：

1. 进入工作区，点 New chat——预期结果是对话流建立，底部出现模型选择与输入框
2. 描述需求后发送——Agent 以流式方式展示思考与工具调用步骤（read / edit / bash），实时显示 token 与费用；执行中你可以steer插话引导，或排队后续指令
3. 遇到不确定的决策，Agent 会停下来提问——它用结构化的选择题卡片在聊天里问你，而不是猜：

Agent 先问后改——问题卡给出选项，确认后才动手；左侧是已沉淀到 shelf 的工作区。

4. 改动完成后看 Changes 面板——它列出被改动的文件与 diff，你可以逐行查看，甚至在某一行留下锚定 review 评论，再把评论作为结构化上下文发回聊天
5. 需要并行时开多个会话——同一工作区可跑多个并发pi会话，各自绑定不同模型；子任务还能委托给 subagents 处理

⚠️ MCP 服务器同样受这套信任机制约束：服务器未标记为只读的调用，ThinkRail 会先在聊天里征求你的同意；仓库自带的 MCP 服务器在你批准前保持关闭。

🧠 Specs：让项目意图跨会话存活

这是 ThinkRail 最有特色的部分，也回答"Agent 为什么越用越懂项目"。

它是什么：仓库里层级化的SPEC.md文件连成一张规格图（spec graph），每个模块旁都有一份同级规格，顶层是 goal-and-requirements.md（产品目标）与 architecture.md（架构设计）。

对你意味着什么：Agent 通过专用spec_*工具读、搜、维护这张图——你改了架构决策，规格跟着改，下个会话的 Agent 不会把上次拍板的决策再翻案。工作台里的 Specs 面板以树状只读渲染整张图，点一个节点就在编辑器里并排渲染对应文档：

项目的规格图谱以树状呈现，当前规格文档在编辑器中同步渲染。

顺带一提，ThinkRail 自己就是 spec-first 开发的：移动任何边界、契约或决策的改动，都在同一次变更里更新对应SPEC.md。想深入某个模块的设计，直接翻它目录下的SPEC.md即可，例如 apps/cli/SPEC.md。

⚙️ 个性化：布局预设、界面语言与主题

工作台可以任意分栏：中心区域可递归拆分，左右是工具面板栈，底部放终端。觉得默认布局不合手？Settings → Layout 提供了三种预设：

Settings → Layout：Balanced、Focus、Review 三种预设一键应用，当前排列也能存成自己的预设。

• Balanced / Focus / Review三种预设，一键应用；"Save current arrangement" 能把当前排列存成自定义预设
• 界面语言：Settings → Language 跟随系统或手动指定，内置英语、日语、简体中文、西班牙语；ThinkRail 还没收编的语言，把一份翻译好的en.json放进~/.thinkrail/locales即可，保存即生效——内置词表参考 packages/locales/en.json
• 主题：内置 dark、light、minimal、high-contrast；把内置的*.theme.json复制出来改掉 id 和配色，存进~/.thinkrail/themes就是一个你自己的主题

⌨️ 常用命令速查

另外，想换一套pi配置（比如个人的~/.pi/agent-personal），可以在 Settings → Environment 里设置，下次启动生效；启动时传PI_CODING_AGENT_DIR=… thinkrail优先级更高。

🏁 小结：从零到第一次 diff 的三步

安装（桌面包或 CLI 一行命令）→打开仓库（自动获得 Default workspace，需要隔离就切 worktree）→New chat（让pi在隔离工作区改代码、出 diff、接受你的逐行审查），再靠 Specs 把项目知识沉淀下来。下一步建议：

• 产品目标与完整能力清单：goal-and-requirements.md
• 三层架构（engine host / wire / UI client）详解：architecture.md
• 贡献指南、检查项与测试流程：CONTRIBUTING.md
• 端到端测试套件：e2e/ 目录，源码入口在 apps/cli/ 与 apps/desktop/

【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址: https://gitcode.com/GitHub_Trending/th/thinkrail