Bỏ qua tới nội dung
Ông T.vn

ThinkRail: IDE AI làm việc theo workspace — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

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 →

ThinkRail: IDE AI làm việc theo workspace — 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.

Ứng dụng

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ả.

★ 8.2kTypeScriptApache-2.0
Xem repo trên GitHub

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. ⌘⇧F tì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 pi và 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 pi mcp.json hoặ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 ~/.thinkrail theo 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

  1. Chọn cách càiDùng desktop installer hoặc CLI thinkrail
  2. Cài ThinkRailTải installer đúng hệ điều hành và chạy
  3. Mở projectChạy thinkrail hoặc chọn project trong ứng dụng
  4. Kết nối providerĐăng nhập JetBrains AI hoặc cấu hình provider của pi
  5. 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.

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

Installer 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:

Terminal
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2 libnotify-bin

Lệ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
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:

Terminal
thinkrail

Hoặc truyền vào một Git repository:

Terminal
thinkrail ~/code/my-repo

Lầ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:

Terminal
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.2

Phiên bản ghim phải thuộc channel đã chọn. Trên Windows, dùng biến môi trường:

PowerShell
$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:

Terminal
thinkrail --help
thinkrail --version

Nế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:

text
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:

text
# 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:

Terminal
thinkrail --no-analytics

Hoặ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.

4.6/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn khô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.

Chuyển nhanh tới mục

  1. I.ThinkRail làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn desktop hoặc CLI
    2. B.Cài CLI trên macOS, Linux hoặc Git Bash
    3. C.Cài CLI trên Windows
    4. D.Mở ThinkRail và chọn project
    5. E.Chọn channel hoặc phiên bản cụ thể
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn sửa nhanh trang quản lý đơn hàng
    2. B.Nhân viên văn phòng cần soạn quy trình nội bộ
    3. C.Dev mới tiếp nhận một dự án khó hiểu
    4. D.Nhóm phát triển cần dùng model server nội bộ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal không nhận lệnh thinkrail
    2. B.Linux desktop thiếu thư viện hệ thống
    3. C.ThinkRail không thể làm việc với repository
    4. D.Chat không chạy vì chưa có provider
    5. E.Không muốn gửi thêm dữ liệu sử dụng
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.