ThinkRail: IDE AI làm việc theo workspace — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về JetBrains/thinkrail — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: JetBrains/thinkrail: IDE agentic làm việc an toàn hơn — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
ThinkRail là IDE agentic chạy pi coding agent trong giao diện desktop hoặc trình duyệt, hỗ trợ workspace Git cô lập, chat AI, spec graph và skills. Cài bằng installer trên macOS, Windows hoặc Linux khá đơn giản; bạn cần Git và một model provider.
ThinkRail là một IDE agentic giúp bạn giao việc cho AI coding agent trong các workspace Git riêng biệt. Công cụ này phù hợp với lập trình viên, nhóm phát triển và người muốn thử nghiệm thay đổi mà không làm ảnh hưởng trực tiếp đến thư mục mã nguồn chính.
Điểm đáng giá nhất là ThinkRail không chỉ mở một khung chat. Nó quản lý workspace, nhánh Git, phiên làm việc, kế hoạch, pull request và kiến thức dự án qua spec graph. AI có thể làm việc song song trong nhiều workspace, còn bạn vẫn xem, kiểm tra và chọn phần thay đổi muốn giữ.
ThinkRail có hai dạng: ứng dụng desktop và CLI thinkrail mở cùng giao diện trong trình duyệt. Công cụ dùng pi coding agent làm engine, nên bạn có thể kết nối JetBrains AI hoặc provider riêng của mình.
JetBrains/thinkrail
ThinkRail là IDE agentic giúp AI làm việc trong workspace Git riêng, duy trì kiến thức dự án và hỗ trợ quy trình phát triển theo đặc tả.
I.ThinkRail làm được gì
Tạo workspace cô lập bằng Git worktree. Bạn có thể mở một repository rồi tạo workspace riêng cho từng nhiệm vụ. Mỗi workspace có nhánh và thư mục làm việc riêng, giúp agent thử thay đổi mà không chạm trực tiếp vào code gốc.
Theo dõi thay đổi và pull request. ThinkRail hiển thị trạng thái nhánh so với
origin, tình trạng pull request và CI checks. Bạn có thể publish, push, mở pull request, đánh dấu sẵn sàng, merge, mở lại hoặc xóa nhánh remote từ giao diện.Làm việc bằng IDE tích hợp. Monaco editor, cây file có thông tin thay đổi Git, terminal và trình xem tài liệu nằm trong cùng giao diện. Markdown được render kèm mục lục để đọc tài liệu dự án dễ hơn.
Mở nhiều phiên chat cùng lúc. Mỗi workspace có thể có nhiều work session, mỗi phiên dùng model riêng. Bạn có thể gửi yêu cầu, xếp yêu cầu tiếp theo, giao việc cho subagent và cùng agent cập nhật một kế hoạch chung.
Tìm kiếm từ một hộp lệnh. Phím
⌘K, hoặc chạm Shift hai lần, giúp tìm chat, tin nhắn, workspace, project, file, spec và plan.⌘⇧Ftìm văn bản trong file và mở đúng dòng có kết quả.Chat không cần repository. Bạn có thể hỏi, lập kế hoạch hoặc soạn thảo trong một scratch folder riêng. Khi công việc phát triển thành dự án, tính năng Continue in workspace tạo bản tóm tắt bàn giao rồi mở workspace chat mới.
Duy trì kiến thức dự án bằng spec graph. Các file
SPEC.mdđược liên kết thành một đồ thị nằm cạnh code. Agent có thể đọc, tìm kiếm và cập nhật chúng bằng các công cụspec_*, giúp ý định của dự án không bị mất giữa các phiên làm việc.Tái sử dụng skills. ThinkRail tải skills của
pivà skills có sẵn trong project. Bạn cũng có thể nhập skills từ Claude, Codex và các coding agent khác qua Settings → Extensions hoặc hộp Skills của từng project.Hỗ trợ công cụ trực quan và câu hỏi có cấu trúc. Agent có thể hỏi bạn bằng lựa chọn nhiều đáp án, vẽ sơ đồ Mermaid, hiển thị so sánh, xem trước file và trình bày mockup trước/sau khi đề xuất thay đổi giao diện.
Kết nối MCP server. Bạn có thể cấu hình MCP trong
pimcp.jsonhoặc trong Settings. Server do repository khai báo sẽ tắt cho tới khi bạn phê duyệt. ThinkRail hỏi trước khi gọi tool mà server không đánh dấu là chỉ đọc.Dùng provider và model server của riêng bạn. Bạn có thể đăng nhập JetBrains AI hoặc dùng credential của provider qua
pi. ThinkRail cũng kết nối được các server tương thích OpenAI như LiteLLM, sglang, vLLM, Ollama, LM Studio và llama.cpp.Tùy chỉnh giao diện. Có lựa chọn ngôn ngữ, theme, font, cỡ chữ, ligature và độ đậm chữ. Bạn có thể thêm locale, theme hoặc font riêng trong thư mục
~/.thinkrailtheo cách README mô tả.Kiểm soát analytics. Ứng dụng gửi các sự kiện sử dụng cơ bản và báo lỗi gắn với installation ID ngẫu nhiên. README nói rõ analytics không chứa prompt, code, file, credential hay danh tính tài khoản.
II.Cần chuẩn bị gì
Git phải có trong
PATH. ThinkRail dùng Git để mở project, tạo worktree, clone repository và quản lý nhánh.Một model provider. Bạn có thể đăng nhập JetBrains AI trong ứng dụng hoặc kết nối credential của provider qua cấu hình riêng của
pi. README không yêu cầu một model cụ thể.Hệ điều hành phù hợp. Desktop hỗ trợ macOS 14 trở lên trên Apple Silicon hoặc Intel, Windows x64, và Linux x64/ARM64. CLI có binary cho macOS, Windows x64 và Linux x64/ARM64.
Nếu dùng Linux desktop, cần glibc 2.38 trở lên cùng GTK 3, WebKitGTK 4.1, Ayatana AppIndicator 3, librsvg 2 và Ubuntu 24.04 trở lên. Desktop build Linux cũng cần
libnotify-binđể gửi thông báo.Credential Git nếu làm việc với GitHub hoặc Git host khác. ThinkRail dùng credential và SSH key đã có trên máy của bạn.
Nếu dùng model server nội bộ, cần địa chỉ server tương thích OpenAI và thông tin kết nối tương ứng. README không nêu yêu cầu phần cứng GPU riêng cho ThinkRail.
III.Cài đặt từng bước
- Chọn cách càiDùng desktop installer hoặc CLI thinkrail
- Cài ThinkRailTải installer đúng hệ điều hành và chạy
- Mở projectChạy thinkrail hoặc chọn project trong ứng dụng
- Kết nối providerĐăng nhập JetBrains AI hoặc cấu hình provider của pi
- Kiểm tra phiên bảnDùng thinkrail --version và mở thử một workspace
A.Chọn desktop hoặc CLI
README cho biết ThinkRail được phát hành dưới dạng native desktop installer và CLI tự chứa. Desktop phù hợp nếu bạn muốn dùng IDE như một ứng dụng riêng. CLI phù hợp nếu bạn muốn chạy một lệnh và mở cùng giao diện trong trình duyệt.
Bạn cần lấy bản phát hành mới nhất từ landing page hoặc Releases page của dự án. Không cần tự build từ source để cài bản dùng hằng ngày. Repository có package.json, nhưng README không ghi quy trình build hoặc chạy monorepo từ mã nguồn.
B.Cài CLI trên macOS, Linux hoặc Git Bash
Mở Terminal. Trên Windows, lệnh này chạy được trong Git Bash.
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bashInstaller tự tải binary phù hợp, kiểm tra SHA-256 rồi đặt thinkrail vào PATH. Nếu terminal báo không tìm thấy thinkrail sau khi cài, hãy mở một cửa sổ terminal mới để nạp lại PATH.
Trên Linux desktop, cài các thư viện hệ thống trước:
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2 libnotify-binLệnh này dành cho hệ thống dùng apt và đáp ứng các thư viện mà desktop build Linux cần. README yêu cầu Ubuntu 24.04 trở lên cùng glibc 2.38+; nếu máy không đáp ứng, hãy dùng đúng bản desktop được hỗ trợ hoặc CLI tương ứng.
C.Cài CLI trên Windows
Mở PowerShell. Lệnh dưới đây tải script cài đặt và chạy nó:
powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"README cũng nói lệnh này chạy được từ Command Prompt và PowerShell. Bản CLI Windows là file .exe đã được ký. Sau khi cài, mở terminal mới nếu lệnh chưa nhận ngay.
D.Mở ThinkRail và chọn project
Chạy không kèm đường dẫn để mở ứng dụng:
thinkrailHoặc truyền vào một Git repository:
thinkrail ~/code/my-repoLần chạy đầu sẽ hướng dẫn bạn kết nối provider và chọn project. Nếu chưa có repository, chọn Start a new project để tạo một Git repository rỗng, mặc định dưới ~/thinkrail.
Bạn cũng có thể vào Add project → Clone repository… để clone Git URL vào máy đang chạy ThinkRail. Chọn thư mục cha và tên thư mục. GitHub cùng các Git host khác dùng credential và SSH key đã cấu hình trên máy.
E.Chọn channel hoặc phiên bản cụ thể
Installer hỗ trợ channel stable, nightly và phiên bản ghim. Với macOS, Linux hoặc Git Bash, truyền tùy chọn sau lệnh cài:
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel stable --version 0.3.1
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly --version 0.4.0-nightly.2Phiên bản ghim phải thuộc channel đã chọn. Trên Windows, dùng biến môi trường:
$env:THINKRAIL_CHANNEL='nightly'; irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex
set "THINKRAIL_CHANNEL=stable" && set "THINKRAIL_VERSION=0.3.1" && powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"README còn có các biến THINKRAIL_PREFIX, THINKRAIL_NO_MODIFY_PATH và THINKRAIL_VERSION cho installer Windows. Chỉ nên dùng channel nightly khi bạn chấp nhận bản thử nghiệm.
IV.Kiểm tra đã chạy được chưa
Kiểm tra lệnh và phiên bản:
thinkrail --help
thinkrail --versionNếu --help hiển thị các flag và --version in ra build, CLI đã được cài và có thể gọi từ terminal. Tiếp theo chạy thinkrail, hoàn tất bước kết nối provider rồi chọn một project.
Cài đặt được xem là hoạt động khi giao diện ThinkRail mở, bạn thấy project hoặc màn hình tạo project, và có thể bắt đầu một chat. Với project Git, hãy thử tạo một workspace riêng rồi kiểm tra cây file, branch và terminal trong workspace đó.
Nếu dùng desktop, mở ứng dụng, vào Settings → Providers để kết nối provider, sau đó mở project. Settings → Updates có thể dùng để kiểm tra và cài bản cập nhật khi có thông báo.
V.Dùng vào việc thật
A.Chủ shop muốn sửa nhanh trang quản lý đơn hàng
Chủ shop có repository của trang quản lý đơn hàng và muốn thử thêm bộ lọc đơn theo trạng thái. Mở project trong ThinkRail, yêu cầu agent làm việc trong workspace riêng bằng câu:
Add an order-status filter in a side workspace. Inspect the existing project conventions, update the relevant files, and explain the changes in the plan.Agent có thể tạo workspace và chat tương ứng, thực hiện thay đổi trong nhánh riêng. Chủ shop xem diff trong cây file, chạy kiểm tra bằng terminal và chỉ merge khi kết quả đúng.
B.Nhân viên văn phòng cần soạn quy trình nội bộ
Một nhân viên có thể mở chat không gắn project để lập kế hoạch hoặc soạn tài liệu. Chat có scratch folder riêng cho file, terminal và plan. Khi tài liệu trở thành một phần của repository, chọn Continue in workspace để agent tạo bản tóm tắt bàn giao và mở workspace chat mới.
Cách này giúp phần trao đổi ban đầu không làm bẩn repository. Khi cần phát triển thành công việc chính thức, lịch sử và kế hoạch vẫn có điểm bàn giao rõ ràng.
Workspace riêng giúp AI thử nghiệm nhanh mà vẫn giữ code gốc an toàn để bạn kiểm tra.
Ông T
C.Dev mới tiếp nhận một dự án khó hiểu
Dev mới có thể dùng spec graph để đọc các file SPEC.md cạnh code. Trong palette, gõ # cùng câu hỏi cần tìm, chẳng hạn:
# How does authentication work?ThinkRail tìm các section phù hợp theo thứ hạng của spec_search. Nhấn Enter để mở spec tại heading tương ứng, hoặc dùng tùy chọn hỏi agent trong chat mới khi cách diễn đạt trong spec khác với câu hỏi.
Kết quả là dev không phải chỉ dựa vào tên file hoặc hỏi lại từ đầu trong mỗi phiên. Agent có thể đọc và duy trì kiến thức dự án qua các công cụ spec chuyên dụng.
D.Nhóm phát triển cần dùng model server nội bộ
Nhóm có gateway LLM hoặc model chạy trong mạng riêng vào Settings → Providers → Custom servers. README nêu các server tương thích OpenAI như LiteLLM, sglang, vLLM, Ollama, LM Studio và llama.cpp.
Sau khi lưu server, bấm Find models để xem model và capability mà server cung cấp. Model xuất hiện trong bộ chọn model của chat và trong pi CLI. Nhóm có thể giữ credential và model server theo hạ tầng của mình thay vì chỉ dùng một provider mặc định.
VI.Lỗi hay gặp và cách xử lý
A.Terminal không nhận lệnh thinkrail
Nguyên nhân thường là terminal đang mở trước khi installer thêm binary vào PATH. Đóng và mở lại terminal rồi chạy thinkrail --version. Nếu vẫn lỗi, kiểm tra installer đã chạy hết chưa và dùng đúng installer cho hệ điều hành.
B.Linux desktop thiếu thư viện hệ thống
Nếu ứng dụng không mở hoặc báo thiếu GTK, WebKitGTK, AppIndicator, librsvg hay thông báo desktop, kiểm tra phiên bản Linux và cài các gói trong phần cài đặt. README yêu cầu Ubuntu 24.04 trở lên, glibc 2.38+ và các thư viện tương ứng.
C.ThinkRail không thể làm việc với repository
Hãy kiểm tra Git có trong PATH và credential hoặc SSH key của Git host đã có trên máy. Nếu clone qua Add project → Clone repository…, kiểm tra Git URL, thư mục cha và tên thư mục trước khi xác nhận.
D.Chat không chạy vì chưa có provider
ThinkRail cần một model provider. Trong lần chạy đầu, hoàn tất bước kết nối JetBrains AI hoặc cấu hình credential của provider qua pi. Nếu dùng server riêng, vào Settings → Providers → Custom servers và kiểm tra server có tương thích OpenAI hay không.
E.Không muốn gửi thêm dữ liệu sử dụng
Tắt Share additional usage data trong Settings → Privacy. Với một lần chạy CLI, dùng:
thinkrail --no-analyticsHoặc đặt biến môi trường THINKRAIL_NO_ANALYTICS=1. README nói analytics cơ bản không bao gồm prompt, code, file, credential hay danh tính tài khoản; khảo sát phản hồi là luồng riêng và chỉ gửi khi bạn bấm Send.
VII.Có nên dùng không
ThinkRail đáng thử nếu bạn muốn AI coding agent làm việc có tổ chức hơn trong project Git. Workspace cô lập, nhiều phiên chat, spec graph, skills, MCP, terminal và theo dõi pull request tạo thành một quy trình khá liền mạch. Người mới cũng có thể bắt đầu bằng desktop app hoặc CLI mà không cần tự dựng toàn bộ môi trường agent.
Công cụ đặc biệt phù hợp với nhóm thường xuyên thử nhiều hướng triển khai, cần review thay đổi trước khi nhập vào nhánh chính, hoặc muốn lưu kiến thức dự án dưới dạng spec. Việc kết nối model server riêng cũng hữu ích cho đội có hạ tầng LLM nội bộ.
Giới hạn cần cân nhắc là ThinkRail phụ thuộc Git và một model provider. README không công bố thông tin về giá, cũng không nêu yêu cầu GPU riêng. Linux desktop có yêu cầu hệ thống khá cụ thể, còn Linux artifacts được mô tả là unsigned. Nếu bạn chỉ cần một editor nhẹ, một chat agent trong terminal hoặc một quy trình không dùng Git worktree, ThinkRail có thể nhiều tính năng hơn nhu cầu.
Repo hiện có khoảng 8.225 sao và 521 fork, dùng TypeScript, giấy phép Apache-2.0 và vẫn được cập nhật. Đây là lựa chọn hợp lý cho người muốn biến AI coding thành một quy trình có workspace, kế hoạch, đặc tả và review rõ ràng.
Câu hỏi thường gặp
ThinkRail có miễn phí không?
README được cung cấp không nêu thông tin giá hoặc gói miễn phí. Tài liệu chỉ nói bạn có thể đăng nhập JetBrains AI hoặc kết nối provider riêng qua pi.
ThinkRail có chạy trên Windows không?
Có. Desktop hỗ trợ Windows x64 với setup ZIP, còn CLI có bản `.exe` cho Windows. README cũng cung cấp lệnh cài PowerShell và nói lệnh này chạy được từ Command Prompt.
Có cần GPU để chạy ThinkRail không?
README không nêu yêu cầu GPU riêng cho ThinkRail. Bạn cần Git và một model provider; model có thể là provider bên ngoài hoặc server riêng tương thích OpenAI.
ThinkRail có cần repository Git sẵn không?
Không bắt buộc. Lần chạy đầu, tùy chọn **Start a new project** có thể tạo một Git repository rỗng. Bạn cũng có thể bắt đầu bằng chat không gắn project hoặc clone repository từ giao diện.
Dữ liệu và prompt có được gửi đi không?
README nói analytics không bao gồm prompt, code, file, credential hay danh tính tài khoản; báo lỗi cũng không chứa file path, tên, URL hoặc dữ liệu project. Provider model vẫn là nơi xử lý yêu cầu của agent, nhưng README không mô tả chính sách dữ liệu của từng provider.
ThinkRail khác gì một coding agent chạy trong terminal?
README mô tả ThinkRail là một thin host chạy pi trong process và thêm giao diện web, quản lý workspace, GUI cùng các hợp đồng giữa engine và GUI. Tài liệu không đưa ra bảng so sánh trực tiếp với một công cụ cụ thể.
Có thể dùng model server nội bộ không?
Có. Settings → Providers → Custom servers hỗ trợ server tương thích OpenAI, gồm LiteLLM, sglang, vLLM, Ollama, LM Studio và llama.cpp. Nút **Find models** liệt kê model và capability của server.


