JetBrains开源了一个叫thinkrail的Agent IDE,一周冲到5000多星,登顶GitHub Trending。
它的卖点很具体:一个任务切一个git worktree,多个Agent并行干活,互不碰你的主目录。听起来像是把“Agent在你项目里乱改”这件事从根上解决了。
我装了 0.3.0-nightly.6 ,接上DeepSeek,开了两个任务同时改同一个文件,中间重启了一次,然后翻了Agent的会话记录。worktree确实把文件隔住了。但有一处没隔住,我用纯git复现了坏情况。
![]()
它到底是个什么东西:JetBrains给pi造了辆座驾
先把定位说清楚,不然容易误会。
thinkrail不是JetBrains自研的编程Agent。README里写得很直白:“a thin host that runs pi”——它是一层壳,跑的是开源Agentpi(MIT协议,11.8万星,作者是libGDX的Mario Zechner和Flask的Armin Ronacher)。
所以它和Claude Code、Cursor的区别不是“谁的Agent更强”,是谁在什么形态里跑Agent。Claude Code是终端里的Agent,Cursor是在IDE里加AI,thinkrail是为Agent行为重新设计了一个IDE:工作区管理、Monaco编辑器、diff审查、SPEC.md图谱,全部围绕“Agent在干活”这件事来组织。
一个有意思的细节:安装包大约140MB,跑在Bun上,React 19前端。IntelliJ IDEA是几个GB。JetBrains在用一个轻量的壳,试探一个和自家重型IDE完全不同的方向。
![]()
worktree隔离了什么,我用两个任务改同一个文件试了一次
thinkrail的默认隔离单元是git worktree。开一个任务,它自动从仓库切出一个独立目录和分支,放在 ~/.thinkrail/worktrees/ 下面,不碰你当前的checkout。
我开了两个工作区,让两个Agent分别修改同一个文件的不同函数。各自提交,主目录的calc.js一个字没动,两个分支合并时没有冲突。这是worktree隔离最直接的证据:文件系统层面,Agent之间确实不打架了。
但有一个模式例外。thinkrail里有一个“Work in project folder”选项,直接在你项目根目录里干活。界面写明了no isolation。如果你在这个模式里开两个对话并行改代码,它们和你的未提交改动是混在一起的。隔离是默认值,不是无条件的。
![]()
真正的问题在.git里:所有worktree共用一个stash栈
这是我没预料到的部分。
git worktree共享同一个 .git 对象库,而 git stash就存在.git。thinkrail的所有工作区,共用同一个stash栈。
我在Agent的会话记录里看到它用了裸 git stash 。然后用纯git复现了一遍:在workspace-1里stash的改动,从workspace-2里git stash pop能把它拿走。A pop回来的是B的东西。
这不会让文件系统隔离失效,但会让“我暂存一下,回头再处理”这个动作在多Agent场景下变得不可预测。worktree隔离了工作目录,没有隔离stash这个共享状态。
还有一个相关的坑:任务spec存在worktree的 .thinkrail/context/ 里,被gitignore;项目spec是仓库根目录的 SPEC.md ,要你自己提交。如果 SPEC.md 没commit,新建的worktree看不到它。这意味着“living specs跨会话存活”这件事,前提是你先把spec写进git。
![]()
living specs:它想让项目知识活得比会话长
SPEC.md的设计是thinkrail区别于其他Agent工具的核心之一。
它不是一个手写的 CLAUDE.md 或 .cursorrules 。thinkrail维护的是一张互相链接的SPEC.md图谱,每个文件描述一个模块、组件或架构决策,通过frontmatter关联。Agent有专门的 spec_* 工具去读取、搜索和维护这张图谱。Agent重构一个模块时,它会更新对应的spec;遇到一个架构约束,它会记下来。下一次会话启动时,Agent读的是同一张图谱,不是从零开始。
这直接回应了一个真实痛点:Claude Code的 CLAUDE.md 和Cursor的 .cursorrules 是人维护的,人会忘、会懒、会过时。thinkrail赌的是Agent自己维护知识库,比人维护得更及时。
但这个赌注还没有被验证。Hacker News上188分、141条评论的讨论里,有一派人认为Agent会把spec随机拉进上下文,形式化的结构并不解决问题。我自己的体感是:图谱的结构是合理的,但Agent维护spec的质量,取决于它有没有被明确要求“改完代码必须更新spec”。默认行为不一定可靠,你得在项目规则里写清楚。
![]()
接DeepSeek很顺,但费用面板不能当账单看
thinkrail本身不配置provider。它继承你已有的pi配置:~/.pi/agent 下的API密钥、权限、技能,直接复用,不需要重新填。
接DeepSeek就是在pi的配置里选provider、填Key,然后在会话里选模型。社区反馈是DeepSeek Flash“速度很快”。
费用面板有一个容易被误读的地方。每个pi会话有自己的token和成本读数,重启后还在,和pi会话记录逐项一致。但单价是写死的美元价,它不知道DeepSeek空闲时段半价。所以面板上的数字是一个参考值,不是你实际扣款的金额。如果你的工作流依赖闲时折扣,面板会高估成本。
![]()
安全这件事:官方推荐 curl | bash ,但三个修复PR还没合并
写thinkrail绕不开安全,因为它对Agent的权限放得很深。
截至10月29日,仓库有222个open issue,5000多星。有安全分析指出了三处问题,修复PR还没合并。
第一,官方推荐的安装方式是 curl | bash 。安装脚本里的 REPO 可以被环境变量覆盖,二进制和SHA256SUMS从同一个地方下载,校验文件和被校验对象来自同一来源,设一个环境变量就能让校验自己给自己盖章。
第二,host的 /ws 端点升级请求时不检查Origin、不要求凭证。浏览器对WebSocket不受同源策略约束,理论上你访问的任意网页都能连上本机端口、以你的身份执行命令。默认端口24242写死在代码里。报告者标注了这是代码审计级发现,未在真实实例上跑通
这不是说thinkrail不能用。但如果你在跑不受信任的仓库,或者把它暴露在共享网络里,这三处值得知道。
![]()
它适合谁,以及我现在的用法
适合的人:已经用pi、想在真实git仓库上把多任务并行跑起来的开发者;需要“Agent改完我能逐行审、审完再合并”的流程,而不是“Agent直接改我的工作区”;愿意花时间把项目规范写成SPEC.md,让后续会话不用重新交代。
需要谨慎的人:指望开箱即用、不愿意配pi和写spec的;对安全边界敏感、无法接受 curl | bash 和WebSocket不校验Origin的;只需要单Agent串行、没有“Agent撞车”问题的(worktree隔离对你没有收益)。
我现在的用法是三条规则,来自实测的踩坑:
并行任务一律走“Start building”建worktree,不在“Work in project folder”里干并行活。想让后续任务读到的SPEC.md,先commit到main。在项目规则里写一句“禁止裸git stash”,要暂存就做临时WIP提交,绕开共享的stash栈。
thinkrail登顶GitHub靠的是前序项目减速,不是自己加速——日增从1204降到了1068。但“IDE厂商亲自下场,把Agent工作区做成第一等公民”这个方向,比它的星数更值得关注。隔离不是免费的,它的代价是你要理解哪些东西在隔离之外。那个共享的stash栈,就是代价之一。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.