基于 Pi Coding Agent 的各类套壳 GUI 已经不少了，JetBrains 也开源了一个 ThinkRail，毕竟出自 IDE 老大哥，工程水准不会差。

这项目几个月前就有了，但没见官方推广，也很少有人提，GitHub Star 才 500 多。我之前纳闷 JetBrains 既然有了官方主推的新 ADE 工具 Air，为什么还要单独做一个专为 Pi 打造的 ThinkRail？

上手体验后发现两者定位不同：Air 是企业级重装航母，而 ThinkRail 是极致轻量的极客工具。它基于 Electrobun（Bun 跨平台桌面方案）开发，内存占用极低。

功能也和市面上的 ADE 差不多： 🔹 Git Worktree 隔离：每个 Workspace 都是独立的 worktree 分支与目录，适合多 Agent 并行开发。 🔹 规范驱动（SDD）​：这个稍微有点特色，让 Agent 先读懂架构设计再施工，彻底防止代码写跑偏。 🔹 简单的 IDE 功能：集成 Monaco 编辑器、实时 Git Diff 审查和独立终端。

全平台均可直接下载体验： 官网：https://thinkrail.ai 项目地址：https://github.com/JetBrains/thinkrail…

ThinkRail — the agentic IDE that gets better every time you use it

Source: https://thinkrail.ai/ <!-- README.md -->

JetBrains InnovationHubApache-2.0open source

The agentic IDE that gets better every time you use it.

Open a repo as a project. Cut isolatedgit-worktree workspaces. Pair with a real agent across Monaco tabs, terminals, and diffs — while your project’s intent lives in aspec graph the agent actually reads.

macOS

Browser UI via command lineInstall the local launcher; runthinkrailto open the browser UI.

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

Windows

Browser UI via command lineInstall the local launcher; runthinkrailto open the browser UI.

PowerShell

irm https://raw\.githubusercontent\.com/JetBrains/thinkrail/main/install\.ps1 \| iex

Command Prompt (cmd)

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

WSL

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

Linux

Browser UI via command lineInstall the local launcher; runthinkrailto open the browser UI.

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

<!-- WHY ThinkRail -->

Why ThinkRail

Agents deserve worktrees, not your working tree.

Every workspace is a realgit worktree— its own branch, its own cwd. Run several agents in parallel; each one’s mess stays on its branch, andmainstays clean until you say otherwise.

Specs are the ground truth.

ThinkRail is built spec-first, and so are your projects: a connected graph of spec files lives beside the code, and the agent reads, searches, and maintains it with dedicated tools. Intent survives the session.

A thin host, a real engine.

Thepicoding agentruns in-process and owns models, skills, compaction, and cost. ThinkRail owns the workspace, the editor, and the wire — it never assembles prompts behind your back.

<!-- FEATURES / worktrees -->

Projects → workspaces

A project is any local git repo. A workspace is agit worktreecut from it — created in one click, listed in the rail, disposable without ceremony.

# one repo, three parallel lines of thought
~/code/my-repo                        ← project
└─ ~/.thinkrail/worktrees/
   ├─ workspace-1   ⎇ feature/auth      agent A building
   ├─ workspace-2   ⎇ fix/flaky-test    agent B fixing
   └─ workspace-3   ⎇ spike/ideas       you, exploring

• Own branch + cwd per workspace — files, diffs, terminals, and chats all scope to it.
• Switch workspaces instantly; nothing reloads, nothing leaks across.
• Merge the good one, delete the rest. Your repo never noticed the chaos.

<!-- FEATURES / editor -->

A real IDE around the agent

Watch the agent work — or work beside it — without leaving the page.

Monaco editor tabs

The VS Code editor engine: syntax everywhere, rendered markdown with a source toggle, file tabs per workspace.

Files tree

The active worktree at a glance — like the rail on the right of this very page.

Changes

A live git diff of the workspace branch, so you review the agent’s work as it lands.

Terminals

Real PTYs scoped to the worktree — run the tests yourself while the agent keeps typing.

<!-- FEATURES / agent-chat -->

Chats that stream like the engine thinks

This transcript is a realpisession, captured in ThinkRail while it worked on its own repo:

Quick tour: what is ThinkRail, and what are the three rings of its architecture? Keep it brief.

readgoal\-and\-requirements\.md·architecture\.md

ThinkRail is the agentic IDE built around thepicoding agent — a thin host that runspiin-process and bridges it to a rich UI, whilepiowns models, skills, compaction, cost, and session state.

Thethree rings:

1. Engine host(packages/server) —createServer\(\)runs an HTTP+WS host plus anAgentSessionManager: one in-processpisession per tab.
2. The wire(packages/contracts) — the typed, versioned protocol between host and UI. Types only.
3. UI client(apps/web) — mobile-first React that ships independently and dials any host over the wire.

Done5s · 25.9k tok · $0.17

• Several sessions per workspace, streaming concurrently.
• Pick the model per session; tokens and cost tick live in the header.
• Steer a running turn or queue a follow-up — no waiting for the agent to finish.
• Interactive tools: the agent can ask structured questions back, right in the chat.

<!-- FEATURES / specs -->

Specs are first-class

Every module carries aSPEC\.mdwith frontmatter linking it into a graph — goal, architecture, modules, tasks. The bundledpi\-spec\-graphextension gives the agentspec\_\*tools to search, navigate, and maintain it, and the Specs tab renders the live graph of your worktree:

ThinkRail — product goal and scopemain spec

ThinkRail — top-level architecturearch

Engine host (server library)module

agent — in-process pi sessionssubmodule

---
id: module-server
type: module-design
status: active
parent: architecture
---

Plain markdown, plain frontmatter, versioned with the code — reading the specs is enough to understand an area and formulate the next task. The agent keeps them honest as it builds.

<!-- INSTALL.md -->

Install

Choose your platform and start working.

Linux: extract the archive, run\./installer, and check thenative library requirements.

Browser UI via command lineInstall the local launcher, then runthinkrailto open the browser UI.

macOS, Linux, WSL

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

Windows PowerShell

irm https://raw\.githubusercontent\.com/JetBrains/thinkrail/main/install\.ps1 \| iex

Command Prompt

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

Requiresgitand an authenticatedpiprovider. Seeall releasesandadvanced CLI options.

<!-- CONTRIBUTING -->

Open source, spec-first

ThinkRail is aJetBrainsInnovationHub project, licensedApache-2.0. The repo is developed spec-first — the top-level specs are the product’s ground truth, and this website is itself a module with aSPEC\.md.

GitHubIssuesContributingCode of ConductReleases