ThinkRail 快速开始：从 Git 仓库到 AI Agent 的第一次协作

【免费下载链接】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

ThinkRail 快速开始指南来了！这是一个围绕picoding agent 构建的 AI Agent IDE（智能体集成开发环境），它把 AI 对话、代码编辑器、Git 变更审查整合进同一个工作台。跟着本文，你只需几分钟就能完成 ThinkRail 安装，打开自己的 Git 仓库，并让 AI Agent 完成第一次代码修改。

ThinkRail 工作台全景：一个pi会话与它产生的变更，都被圈定在隔离的 git worktree 工作区里。

🧭 30 秒了解 ThinkRail

在动手之前，先搞清楚它是什么、给你什么：

• AI Agent 原生工作台：编辑器、文件树、终端、Diff 审查全部围绕piagent 组织，而不是在对话框外再开一个 IDE
• 工作区隔离：每个 Git 仓库可切出多个 workspace（底层是git worktree），每个工作区有自己的分支和工作目录，多个 Agent 可以并行干活而不互相干扰
• Specs 规格图：项目里的SPEC.md组成一张规格知识图谱，Agent 通过spec_*工具读写它，项目意图可以跨会话保留

官方文档入口：README.md，产品目标与设计规格见 goal-and-requirements.md 和 architecture.md。

🚀 一键安装：桌面版或 CLI 任选

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

方式一：桌面版（Desktop）

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

方式二：CLI 命令行（更轻量）

安装脚本会自动下载正确的二进制、校验 SHA-256 并把thinkrail加入 PATH。macOS / Linux 执行（脚本源码见 install.sh）：

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

Windows（PowerShell 或 cmd 均可，脚本见 install.ps1）：

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

装好后，直接带上一个 Git 仓库路径就能启动：

thinkrail ~/code/my-repo

⚠️ 前置条件：系统 PATH 中要有git，并且需要一个大模型 provider——可以在应用里登录 JetBrains AI，或通过pi自带的 auth 连接你自己的 provider。ThinkRail 本身没有账号体系。

🛠 从源码运行 ThinkRail（Bun + Git 工作流）

如果你想参与开发，或体验最新的 nightly 功能，从源码运行也很简单。环境要求：

• Bun1.4.3（仓库锁定的包管理器与运行时）
• Node.js≥ 22.19（进程内pi引擎需要）
• 一个已认证的piprovider（用于 agent 工作）

完整命令：

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

bun run dev会同时拉起 engine host（packages/server/）和 Web 客户端（apps/web/），Ctrl+C即全部停止。源码运行时的应用状态（项目、工作区、worktree）统一存放在~/.thinkrail。更多开发细节见 CONTRIBUTING.md。

📂 打开第一个项目：工作区即 Git worktree

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

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

• 在 Default workspace 里：AI 的改动直接落在你的项目目录，适合"就地干活"
• 新建隔离 workspace：底层自动创建git worktree，独立分支、独立目录，Agent 改崩了也不影响你的主分支；合并好分支后删除其余工作区即可

完成的、休眠的工作区会自动"沉淀"到项目级的 Settled shelf 上（PR 合并或关闭后、或安静一周后），随时点回来继续。顶栏实时显示当前分支相对origin的状态，下一步操作（push、open PR）一键可达。

💬 与 AI Agent 的第一次协作

Agent 遇到不确定的决策时会停下来提问，确认后再动手改代码——每个工作区可以跑多个并发pi会话。

进入工作区后点New chat，第一次协作建议从一个低风险任务开始，比如：

1. 在输入框描述需求，例如"给 CLI 的--help输出补一个用法示例"
2. Agent 会以流式方式展示思考、工具调用步骤（read / edit / bash），实时显示 token 与费用
3. 执行过程中可以随时steer（插话引导）或排队后续指令
4. 完成后，中间的Changes面板列出它改动的文件与 diff，你可以逐行查看，甚至对某一行留下 review 评论再发回聊天

同一个工作区可以开多个并发会话，各自绑定不同模型；遇到子任务还能委托给 subagents 并行处理。

📐 Specs：让 AI 长期记住你的项目

Specs 工具以树状展示项目规格图谱，并排渲染当前规格文档。

这是 ThinkRail 最有特色的部分：仓库里层级化的SPEC.md文件构成一张规格图（spec graph），顶层是 goal-and-requirements.md 与 architecture.md，每个模块旁都有同级的SPEC.md。

• Agent 通过专用spec_*工具读、搜、维护这张图谱
• 你改了架构决策，规格跟着改，意图就不会在会话之间丢失
• 工作台里的 Specs 面板可直接浏览整棵树（只读渲染）

🎨 个性化你的工作台（可选）

在 Settings → Layout 里选择工作台布局预设，或保存自己的排列方式。

ThinkRail 的工作台可以任意分栏：中心区域可递归拆分，左右两侧是工具面板栈，底部放终端。不喜欢默认布局？Settings → Layout 提供了Balanced / Focus / Review三种预设，一键应用；你也可以把当前排列存成自定义预设。界面语言在 Settings → Language 跟随系统，还可以把一份翻译好的en.json放进~/.thinkrail/locales热加载（内置词表见 packages/locales/en.json）。

⌨️ 常用命令速查

下一步去哪儿？

• 产品与架构规格：goal-and-requirements.md、architecture.md
• 贡献指南与测试流程：CONTRIBUTING.md
• CLI 源码：apps/cli/ · 桌面版源码：apps/desktop/
• 每个模块的详细规格：直接翻对应目录下的SPEC.md

🏁 小结

ThinkRail 快速开始三步走：安装（桌面版或 CLI 一键完成）→打开 Git 仓库（自动获得 Default 工作区）→New chat（让piagent 在隔离的 worktree 里改代码、出 diff、可审查）。它把 AI Agent 放进真正的 IDE 语境里，再用 Specs 让项目知识沉淀下来——用一次就熟一分，这就是它"越用越懂你"的原因。

【免费下载链接】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