개요

ThinkRail은 JetBrains가 인큐베이터 프로젝트로 공개한 에이전트 IDE다. 직접 만든 에이전트가 아니라 오픈소스 코딩 에이전트 pi(@earendil-works/pi-coding-agent)를 같은 프로세스에서 돌리고, 그 둘레에 워크스페이스·편집기·리뷰 UI를 얹었다. README의 표어는 “쓸수록 나아지는 에이전트 IDE”다. 지금은 살아 있는 명세(living specs) 로 프로젝트를 학습시키고, 앞으로는 확장 기능으로 스스로 도구를 만든다는 방향이다.

2026-10-28 기준 스타 4,617개, 포크 240개, 라이선스 Apache-2.0, 언어 TypeScript다. 저장소는 2026-07-08에 만들어졌다. 안정판은 v0.2.0(10-18)이고 나이틀리는 v0.3.0-nightly.9(10-28)까지 나왔다. 이 위키는 10월 26일 GeekNews 다이제스트에서 이름만 한 줄로 다뤘다(2026-10-26-geeknews-digest). 이 노트는 README 원문 기준이다.

핵심 기능

영역내용
격리 작업공간git 저장소를 프로젝트로 열고 git worktree로 작업공간을 만든다. 작업공간마다 브랜치와 디렉터리가 따로라 에이전트 여러 개가 내 체크아웃을 건드리지 않고 병렬로 일한다. PR이 머지·종료되거나 일주일간 조용하면 프로젝트별 “선반”으로 저절로 옮겨지고, 다시 작업하면 돌아온다
PR 흐름상단바에 origin·PR 대비 브랜치 상태가 보인다. 게시·푸시·PR 열기(계획·커밋·PR 템플릿·에이전트 초안으로 설명 작성), CI 체크와 리뷰 결정 표시, 실패한 체크를 에이전트에게 넘기기, 저장소가 마지막으로 쓴 방식으로 머지
IDE 환경분할 가능한 Monaco 편집기 탭, git 변경 표시가 붙은 파일 트리, 터미널, 문서. 파일·diff에 붙이는 리뷰 코멘트를 구조화된 맥락으로 채팅에 보낸다
채팅작업공간당 pi 세션 여러 개, 세션별 모델과 실시간 토큰·비용 표시. 실행 중인 턴을 조종하거나 후속 작업을 대기열에 넣고, 서브에이전트에 위임한다. 에이전트가 갱신하고 사람이 고치는 공유 계획의 단계마다 커밋·리뷰할 수 있다
명세코드 옆에 연결된 SPEC.md 그래프를 두고, 에이전트가 spec_* 도구로 읽고 검색하고 유지한다. 읽기 전용 Specs 도구가 트리로 보여 준다
스킬·워크플로우다른 코딩 에이전트용으로 쓰던 Agent Skills를 제자리에서 읽는다. 프로젝트 설정·설계 브레인스토밍·PR 올리기 워크플로우가 번들돼 있다
에이전트 도구웹 리서치, 추측 대신 채팅에서 묻는 객관식 질문, 채팅 안에 그려지는 다이어그램·옵션 비교·파일 미리보기. UI 변경을 제안할 때 전/후 목업을 보여 주고 diff처럼 코멘트를 달 수 있다
MCPpi의 mcp.json 서버를 연결한다. 읽기 전용으로 표시되지 않은 호출은 채팅에서 묻고, 저장소가 정의한 서버는 승인 전까지 꺼 둔다. OAuth 로그인 지원

질문 도구와 시각화 도구는 일반 pi 패키지로도 나온다(@thinkrail/pi-ask-user-question, @thinkrail/pi-visualize). 터미널의 순정 pi에서도 pi install npm:…으로 쓸 수 있다.

설치와 사용

  • 데스크톱: macOS 14+(Apple Silicon·Intel DMG), Windows x64, Linux x64·ARM64. Linux는 glibc 2.38+와 GTK 3·WebKitGTK 4.1 등이 필요하다. 설치본은 백그라운드에서 업데이트를 확인하고 Install & Restart를 눌러야 적용한다.
  • CLI: 저장소의 install.sh(Windows는 install.ps1)가 바이너리를 받아 SHA-256을 검증하고 PATH에 thinkrail을 넣는다. thinkrail ~/code/my-repo로 열면 같은 앱이 브라우저에서 뜬다. --channel stable|nightly, --version으로 고정할 수 있다.
  • git이 PATH에 있어야 하고 모델 제공자가 필요하다. JetBrains AI로 로그인하거나 pi의 인증으로 아무 제공자나 붙인다. ThinkRail 자체 계정은 없다.
  • 기존 pi 설정(~/.pi/agent)을 읽고, 앱 상태는 ~/.thinkrail에 둔다. 인터페이스 언어는 영어·일본어·중국어 간체·스페인어가 내장이고 한국어는 없다. ~/.thinkrail/locales에 번역 en.json을 넣어 추가할 수 있다.
  • 서명 상태: Windows 산출물은 JetBrains가 서명했다. macOS CLI는 서명만 되고 공증은 안 됐으며, 오래된 DMG나 로컬 빌드는 Gatekeeper에 막힐 수 있다. Linux는 서명이 없다.

구조

README는 “프롬프트를 몰래 조립하지 않는 얇은 호스트”라고 설명한다. 모델·스킬·압축·비용·세션 상태는 pi가 맡고, 앱은 작업공간·편집기·통신선만 맡는다.

  1. 엔진 호스트 — packages/server: Bun.serve HTTP+WS 서버가 채팅마다 pi 세션 하나를 같은 프로세스에서 돌린다. apps/cli나 apps/desktop이 실행한다.
  2. 통신선 — packages/contracts: 호스트와 UI 사이의 타입이 붙은 버전 관리 프로토콜.
  3. UI 클라이언트 — apps/web: React 19 + Zustand + Tailwind v4. 호스트에 접속하며 contracts에만 의존한다.

개발은 Bun 1.4.4, Node.js 22.19 이상이 필요하다. 데스크톱 패키징은 Electrobun을 쓴다. 프로젝트 자체도 명세 우선으로 개발한다. 모듈마다 SPEC.md가 옆에 있고, 경계·계약·결정을 바꾸는 변경은 같은 변경에서 명세도 고친다.

개인정보

사용 이벤트(실행·채팅 생성·메시지 전송·제공자 연결)가 임의 설치 ID와 함께 PostHog로 전송된다. 프롬프트·코드·파일·자격증명은 포함하지 않는다고 한다. 오류 보고는 항상 전송되고, 추가 사용 데이터는 Settings → Privacy의 스위치가 켜졌을 때만 보낸다. thinkrail --no-analytics(또는 THINKRAIL_NO_ANALYTICS=1)로 한 번의 실행에서 끌 수 있다.

한계와 확인 못 한 것

  • README만 읽었다. SPEC.md 그래프의 실제 모양, spec_* 도구 목록, architecture.md는 읽지 않았다.
  • “자기 기능을 스스로 만드는” 확장 지원은 README상 예정이다. 현재 기능으로 읽으면 안 된다.
  • 쓸수록 나아진다는 주장은 명세·스킬에 지식이 쌓인다는 뜻이지, 모델이 학습한다는 뜻이 아니다.
  • 나이틀리가 하루에도 여러 번 나오는 초기 프로젝트라 수치와 기능은 빨리 바뀐다.

위키 안 연결

  • 비슷한 문제(여러 코딩 에이전트를 한 창에서 운용)를 다룬 노트: 2026-10-20-x-aicodeking-pandacode, 2026-10-17-x-adibhanna-muxin. 둘과 달리 ThinkRail은 특정 에이전트(pi)에 깊게 묶이고 명세 그래프를 중심 장치로 둔다.
  • MCP 승인 정책(비읽기 전용 호출은 묻고, 저장소 정의 서버는 기본 꺼 둠)은 mcp와 맞닿는다.
  • 반응 (10월 29일, @TiagerBao): “JetBrains도 AI 네이티브 IDE를 만들기 시작했고 바로 오픈소스로 냈다”며 별 5,000개 가까이 모였다고 소개했다. 가장 기대하는 점으로 에이전트별 Worktree 격리와 SPEC.md 영속 문서를 꼽았다. AI가 코드를 빨리 쓸수록 여러 에이전트의 변경을 어떻게 합치고 충돌을 피하느냐가 더 골치라는 이유다.
  • 지도: moc-ai-coding, moc-ai-agents.