Nhiều thư mục, một dự án
cho mọi agent AI bạn khởi chạy
Một trò chơi ở một thư mục và bản port của nó sang phiên bản engine mới hơn ở thư mục khác. Một ứng dụng web và API mà nó gọi, trong hai repository. Một thư viện dùng chung nằm cạnh các ứng dụng sử dụng nó. Agent của bạn cần cả hai phía, và việc dời các thư mục vào chung một thư mục cha sẽ làm hỏng một thiết lập đang chạy tốt.
Thay vào đó, hãy liên kết các thư mục kia với dự án. Chúng ở nguyên chỗ cũ và giữ quản lý phiên bản riêng. Mọi agent bạn khởi chạy trong dự án đều nhận chúng: qua --add-dir trên Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code và Mistral Vibe, và trong brief của agent với các CLI khác. Sau đó tab Thay đổi cho bạn review và commit từng repository.
- /work/web-appThư mục dự án · git
- /work/apiThư mục liên kết · git
- /work/shared-libThư mục liên kết · git
Một dự án, ba repository: mỗi agent khởi chạy trong thư mục dự án và nhận hai thư mục còn lại, theo dạng mà CLI của nó hiểu được.
Một agent khởi chạy trong một thư mục, và phần lớn CLI giữ nó ở đó. Nó thường đọc được xung quanh, nhưng sửa ra ngoài thư mục làm việc nghĩa là gặp một yêu cầu cấp quyền, một lần sandbox từ chối, hoặc một cờ bạn phải nhớ ở mỗi lần khởi chạy. Mọi chuyện ổn cho đến khi công việc trải ra hai nơi: ứng dụng và API của nó, một trò chơi và bản sao của nó trên engine mới hơn, một thư viện và các dự án dùng nó.
Các cách xử lý quen thuộc đều có cái giá. Dời cả hai thư mục vào chung một thư mục cha làm hỏng đường dẫn, script và thiết lập trình soạn thảo vốn đang chạy được. Symlink làm một số công cụ bị rối và che mất nơi tệp thật sự nằm. Gõ --add-dir ở mỗi lần khởi chạy thì được, cho đến đúng lần bạn quên.
Thư mục liên kết là một danh sách được lưu trên dự án. Bạn thêm một thư mục một lần, trong Cài đặt dự án, Chung, Thư mục liên kết. Từ đó, mọi agent của dự án, dù bạn khởi chạy nó từ danh sách agent, từ một ticket backlog hay từ điện thoại, đều nhận các thư mục đó, và mỗi thư mục giữ repository riêng của mình.
Thư mục liên kết làm được gì
Một danh sách trên dự án, được đọc ở mỗi lần khởi chạy. Một dự án không có thư mục liên kết vẫn hoạt động đúng như trước.
Thư mục ở nguyên chỗ
Chọn một thư mục bằng hộp thoại chọn thư mục của hệ thống. Không có gì bị di chuyển, sao chép hay tạo symlink, và mỗi thư mục giữ repository, nhánh và lịch sử riêng. Tối đa mười thư mục cho mỗi dự án.
Đúng cờ cho từng CLI
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code và Mistral Vibe nhận từng thư mục qua cờ --add-dir của chính chúng, cả khi agent khởi chạy mới lẫn khi nó tiếp tục một phiên.
Được ghi trong brief của agent
Mọi agent, dù dùng CLI nào, cũng nhận một đoạn ngắn trong brief: các thư mục, việc chúng thuộc về dự án, và việc git được chạy từ bên trong từng thư mục. Các CLI không có cờ truy cập chúng bằng đường dẫn đầy đủ khi sandbox của chúng cho phép.
Commit từng repository
Trong tab Thay đổi, một bộ chọn repository liệt kê thư mục dự án và mọi thư mục liên kết là git repository. Chọn một cái để xem diff của nó, rồi stage, commit và push nó.
Trên điện thoại cũng vậy
Một agent khởi chạy từ ứng dụng di động AgentsRoom nhận cùng các cờ và cùng brief, vì chính ứng dụng desktop dựng lệnh khởi chạy. Điện thoại hiển thị các thư mục liên kết trong menu dự án, và màn hình Thay đổi của nó cũng cho chọn các repository được liên kết.
Được kiểm tra khi khởi chạy
Một thư mục không còn trên đĩa, ví dụ nằm trên ổ đã rút ra, vẫn ở trong danh sách kèm cảnh báo và bị bỏ qua khi khởi chạy, với một dòng ghi chú trong terminal. Chính thư mục dự án và các thư mục trùng lặp đều bị từ chối.
Cách hoạt động
Bốn bước, và hai bước đầu chỉ làm một lần cho mỗi dự án.
- 1
Mở cài đặt dự án
Cài đặt dự án, Chung, Thư mục liên kết. Trường này cho biết CLI nào nhận các thư mục qua cờ và các CLI khác truy cập chúng ra sao.
- 2
Thêm một thư mục
Thêm thư mục mở hộp thoại chọn thư mục của hệ thống, và thư mục được lưu ngay. Dấu chéo bên cạnh dùng để gỡ nó khỏi dự án về sau: không có gì trên đĩa thay đổi.
- 3
Khởi chạy một agent
Khởi chạy bất kỳ agent nào của dự án như thường lệ: từ danh sách agent, từ một ticket backlog hoặc từ điện thoại của bạn. Nó khởi chạy trong thư mục dự án và có cả các thư mục liên kết.
- 4
Review và commit từng repository
Mở tab Thay đổi và chọn một repository: thư mục dự án hoặc một thư mục liên kết. Đọc diff của nó, rồi stage, commit và push ngay tại đó. Mỗi thư mục giữ lịch sử riêng.
Claude Code và Codex vốn đã thêm được thư mục. Đây là điều thay đổi
Claude Code nhận --add-dir khi khởi động và /add-dir trong một phiên, và giữ một danh sách lâu dài trong additionalDirectories của các tệp cài đặt. Một thư mục được thêm có quyền truy cập tệp theo cùng quy tắc cấp quyền như thư mục làm việc. Từ một thư mục được truyền bằng --add-dir hoặc /add-dir, nó còn nạp kỹ năng, lệnh và subagent, nhưng không nạp CLAUDE.md của thư mục đó trừ khi đặt CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1; một thư mục ghi trong tệp cài đặt chỉ được cấp quyền truy cập tệp. Đã kiểm tra trên tài liệu Claude Code và phiên bản 2.1.300 vào tháng 10 năm 2026.
Codex cũng có --add-dir, giúp một thư mục ghi được bên cạnh workspace chính, và writable_roots dưới sandbox_workspace_write trong config.toml cho một danh sách lâu dài (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code và Mistral Vibe đều có --add-dir riêng.
Vậy cờ không phải là phần mới. Điều AgentsRoom thêm vào là danh sách được lưu trên dự án và truyền cho mọi agent ở mỗi lần khởi chạy, theo đúng dạng mà từng CLI chờ đợi (Claude Code cần cờ và thư mục liền một khối, như --add-dir=/work/api, nếu không tùy chọn đó sẽ nuốt luôn prompt phía sau), cùng một brief cho các CLI không có cờ, các lần khởi chạy từ điện thoại nhận đúng các thư mục đó, và một tab Thay đổi commit được từng repository. AgentsRoom không đặt CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD thay bạn.
Điều cần biết
- Commit tự động khi một ticket hoàn tất, một worktree cho mỗi ticket và diff theo bước của nhóm vẫn chỉ áp dụng cho thư mục dự án. Trong một thư mục liên kết, bạn review và commit thủ công.
- Danh sách được lưu trên từng máy tính, vì một đường dẫn như D:\Games\UE5 không có nghĩa gì trên máy khác. Hãy thêm lại các thư mục trên những máy tính khác của bạn.
- Một agent khởi chạy trên máy chủ từ xa qua SSH không nhận các thư mục liên kết: đó là đường dẫn trên máy tính này. Một dòng trong terminal của nó báo điều đó.
- OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin và Cursor không có cờ cho thư mục bổ sung. Agent của chúng tìm thấy các thư mục trong brief và chỉ truy cập được bằng đường dẫn đầy đủ khi sandbox của chính chúng cho phép.
- Điện thoại hiển thị danh sách nhưng không sửa được: thư mục được chọn bằng hộp thoại chọn thư mục của máy tính.
- Tối đa mười thư mục cho mỗi dự án, vì lệnh khởi chạy bị giới hạn độ dài trên Windows.
Câu hỏi thường gặp
Làm sao để Claude Code truy cập nhiều thư mục?
Trong chính Claude Code: --add-dir kèm một đường dẫn khi khởi động, /add-dir trong một phiên, hoặc additionalDirectories trong tệp cài đặt cho một danh sách lâu dài. Trong AgentsRoom, thêm các thư mục một lần dưới dạng thư mục liên kết của dự án (Cài đặt dự án, Chung, Thư mục liên kết): khi đó mọi agent Claude Code của dự án khởi chạy với --add-dir cho từng thư mục, và các agent của những CLI khác có cờ này cũng vậy.
Codex có làm việc trên nhiều repo được không?
Có. Codex khởi chạy trong một workspace, --add-dir giúp một thư mục khác ghi được bên cạnh, và writable_roots trong config.toml giữ một danh sách lâu dài. AgentsRoom truyền --add-dir cho mọi agent Codex của dự án với từng thư mục liên kết, kể cả khi agent tiếp tục một phiên, và brief của nó dặn chạy git từ bên trong từng repository.
Một dự án có thể gồm nhiều git repository không?
Có. Dự án giữ thư mục chính của nó, nơi các agent khởi chạy, và liên kết các repository khác. Mỗi cái giữ quản lý phiên bản riêng. Trong tab Thay đổi, bộ chọn repository chuyển qua lại giữa thư mục dự án và từng repository được liên kết để đọc diff, commit và push.
Thư mục của tôi có bị di chuyển, sao chép hay tạo symlink không?
Không. AgentsRoom chỉ lưu đường dẫn của chúng và truyền cho các agent khi khởi chạy. Không có gì trên đĩa thay đổi khi bạn thêm hay gỡ một thư mục liên kết.
Những CLI agent nào nhận các thư mục liên kết?
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code và Mistral Vibe nhận từng thư mục qua cờ --add-dir của chính chúng. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin và Cursor không có cờ như vậy: chúng tìm thấy các thư mục trong brief và mở chúng bằng đường dẫn đầy đủ khi sandbox cho phép.
Agent có đọc CLAUDE.md của một thư mục liên kết không?
Mặc định là không. Claude Code nạp kỹ năng, lệnh và subagent của một thư mục được truyền bằng --add-dir, nhưng chỉ nạp CLAUDE.md của nó khi đặt CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1, và AgentsRoom không đặt biến đó thay bạn. Thứ mà mọi agent đều nhận được là brief: mỗi thư mục liên kết nằm ở đâu, rằng nó thuộc về dự án, và rằng nó giữ quản lý phiên bản riêng.
Worktree và tự động commit có áp dụng cho các thư mục liên kết không?
Không, chúng chỉ áp dụng cho thư mục dự án: một worktree cho mỗi ticket, commit tự động khi một ticket hoàn tất, và diff theo bước của nhóm. Trong một thư mục liên kết, hãy review và commit thủ công từ tab Thay đổi.
Thư mục liên kết có theo tôi sang các máy tính khác không?
Không. Danh sách được lưu trên máy tính nơi bạn tạo nó, vì đường dẫn thư mục chỉ tồn tại ở đó. Các agent khởi chạy trên máy chủ từ xa qua SSH cũng không nhận các thư mục này. Phần còn lại của dự án, gồm agent, backlog và cài đặt, vẫn theo tài khoản của bạn như thường lệ.
Tính năng này có chạy trên Windows và Linux không?
Có, trên macOS, Windows và Linux. Trên Windows, ký tự ổ đĩa và cả hai kiểu dấu gạch chéo đều được hiểu, và mỗi --add-dir được đặt trong dấu ngoặc kép cho PowerShell.
Có thể bạn cũng thích
Đa dự án · Đa agent · Song song
AgentsRoom chạy nhiều AI agent Claude, Codex, GitHub Copilot CLI, Cursor và 10 CLI agent khác song song trên nhiều dự án, tất cả trong một cửa sổ duy nhất. Vai trò gắn mã màu, trạng thái trực tiếp, bộ đếm theo từng dự án, thông báo gốc trên desktop và di động. Giải pháp trực quan thay cho 12 tab terminal và sự hỗn loạn của các phiên Claude Code rải rác khắp iTerm2, Warp và tmux.
Git worktree
Cho mỗi agent AI hoặc mỗi ticket một git worktree riêng, sẵn sàng để build (đã cài phụ thuộc, đã sao chép .env), rồi review, commit và gộp nó từ một cửa sổ duy nhất.
Review Theo Từng Agent
Xem lại các thay đổi code từ mỗi agent AI riêng biệt. AgentsRoom theo dõi agent Claude Code nào đã sửa đổi file nào. Lọc diff theo agent, xem lại riêng lẻ, commit theo agent để có lịch sử git gọn gàng.
Multi-Provider
AgentsRoom hỗ trợ 14 nhà cung cấp AI coding: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin và Cursor. Giao một nhà cung cấp khác nhau cho từng agent, chuyển đổi nhà cung cấp giữa chừng cuộc trò chuyện và giữ nguyên ngữ cảnh đầy đủ với handoff tự động. Công cụ AI coding multi-provider tốt nhất.
Kết nối SSH
Lưu các kết nối SSH của bạn, mở terminal tích hợp qua SSH và chạy Claude Code, Codex hoặc Antigravity CLI trực tiếp trên máy chủ từ xa hay VPS của bạn. Xác thực bằng khóa SSH hoặc mật khẩu, hồ sơ kết nối theo từng dự án, không cần ứng dụng SSH riêng.
Cho agent của bạn cả dự án
Tải AgentsRoom, mở repository chính của bạn làm dự án và liên kết các repository khác trong Cài đặt dự án, Chung, Thư mục liên kết.
Ứng dụng đồng hành: theo dõi agent khi đi đường
Sử dụng Claude, Codex, Antigravity CLI hoặc nhà cung cấp AI khác.
Gửi lỗi và yêu cầu thẳng vào backlog công khai của bạn.