JetBrains/thinkrail

ThinkRail 是 JetBrains 的 incubator 專案,把 pi coding agent 包進一個可分割版面的桌面 IDE,並用 git worktree 把每個任務隔離成獨立工作區。它讓 agent 透過 SPEC.md 規格圖譜累積專案知識,並沿用你既有的 pi 設定與 Agent Skills。除了原生桌面程式,也提供 thinkrail CLI 在瀏覽器開啟同一個介面。
AI 寫程式與 SkillsTypeScript★ 4,738

專案簡介

以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。

原始描述

Vibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need

AI 規格

支援的模型供應商JetBrains AI
費用需自備 JetBrains AI 或 pi 供應商憑證,README 未說明計費方式
可搭配的工具pi

主要功能

  • 以 git worktree 切出獨立工作區,agent 可平行作業不碰主要 checkout
  • Monaco 編輯器、檔案樹、終端機與 diff 檢視都綁定目前工作區
  • 每個工作區可同時跑多個 pi session,各自選模型並顯示 token 與成本
  • SPEC.md 規格圖譜由 agent 透過 spec_* 工具讀寫維護
  • 讀取既有的 Agent Skills,內建專案設定、設計發想與開 PR 的工作流程
  • 透過 pi 的 mcp.json 連接 MCP 伺服器,非唯讀呼叫會先在聊天中詢問

系統需求

  • git 需在 PATH 上
  • JetBrains AI 帳號或自備的 pi 供應商憑證
  • macOS 14+(Apple Silicon 或 Intel)
  • Windows x64
  • Linux x64/ARM64,glibc 2.38+,需 GTK 3、WebKitGTK 4.1、Ayatana AppIndicator 3、librsvg 2(Ubuntu 24.04 以上)
  • 從原始碼開發:Bun 1.4.4、Node.js ≥ 22.19

安裝方式

  1. macOS/Linux(Windows 的 Git Bash 亦可)安裝 CLI

    curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash
  2. Windows 以 PowerShell 安裝 CLI

    powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"
  3. Linux 桌面版安裝 GTK、WebKitGTK 等系統相依套件

    sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2
  4. 啟動並開啟指定 git repo 作為專案

    thinkrail ~/code/my-repo

快速開始

thinkrail ~/code/my-repo

設定教學

CLI 需要 PATH 上有 git,並在首次啟動時連上 JetBrains AI 或自備的 pi 供應商憑證。ThinkRail 會讀取既有的 ~/.pi/agent 設定,也可在 Settings → Environment 指定其他目錄或額外環境變數。

環境變數

變數用途必填範例/預設值
PI_CODING_AGENT_DIR指定 pi 設定目錄,啟動時設定會覆蓋 Settings → Environment 的值否—
THINKRAIL_CHANNELWindows 安裝時選擇 stable 或 nightly 頻道否nightly
THINKRAIL_VERSIONWindows 安裝時指定要安裝的版本否0.1.2
THINKRAIL_PREFIXWindows 安裝時指定安裝路徑前綴否—
THINKRAIL_NO_MODIFY_PATHWindows 安裝時不要修改 PATH否—

主要設定檔

  • package.json — monorepo 的 workspace 與 catalog 版本鎖定,開發時調整依賴版本

設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。

適合用途

  • 想讓 agent 在多個 git 分支上平行改 code 又不弄髒主要 checkout 的開發者
  • 已經在用 pi,想換成有編輯器、diff 與 PR 流程的圖形介面的使用者
  • 需要把專案意圖寫成 SPEC.md 並讓 agent 長期維護的團隊
  • 想在桌面應用或瀏覽器之間切換同一套工作環境的人

常見問題

一定要先有 git repo 才能用嗎?

不需要。首次啟動可以選 Start a new project,會在 ~/thinkrail 下建立空的 git repository。

執行 ThinkRail 需要什麼前置條件?

需要 PATH 上有 git,並連上 JetBrains AI 或自備的 pi 供應商憑證。Linux 桌面版另外要 glibc 2.38+、GTK 3、WebKitGTK 4.1、Ayatana AppIndicator 3 與 librsvg 2。

資料存在哪裡?

應用程式狀態存在 ~/.thinkrail,agent 設定則沿用既有的 ~/.pi/agent。

可以沿用我原本的 pi 設定嗎?

可以。ThinkRail 會讀取既有的 ~/.pi/agent,也能在 Settings → Environment 指定別的目錄;啟動時設定的 PI_CODING_AGENT_DIR 優先。

可以自己加介面語言嗎?

可以。把翻譯後的 JSON 放進 ~/.thinkrail/locales,存檔後就會套用;內建英文、日文、簡體中文與西班牙文。

可以關掉 agent 的某些工具嗎?

可以。Settings → Extensions 會列出 agent 可用的 ThinkRail 擴充,並讓你逐一關閉。

公開標籤

agentagent-skillsagentic-aiagentic-workflowai-codingai-toolspi-agentpi-agent-extensionspec-drivenspec-driven-coding
Stars 等欄位只是 GitHub 快照,不保證品質、安全性或商用適用性。