crossweave cho mỗi agent lập trình một git worktree và một shell riêng, cho bạn thấy cái nào đang chạy, đang hỏi hay đã xong, và trial merge chạy nền để bạn chỉ land (đưa vào nhánh chính) cái đứng vững. Dành cho lập trình viên đã chạy Claude Code, Codex hoặc Gemini trong nhiều terminal.
Cài đặt (macOS và Linux)
curl -fsSL https://raw.githubusercontent.com/NMHx2005/crossweave/main/install.sh | shMột bản demo có kịch bản trên một dự án bịa ra, quay trên bản đang phát triển (v0.6.0): session, commit và merge là thật, màn hình agent là kịch bản và các dấu trạng thái được gửi bằng cw notify.
Ba bước, đều trong terminal và shell của chính bạn.
cw session new api
Mỗi cái có worktree, branch và dải port riêng, và một shell trong đó.
claude
Gõ claude, codex hoặc lệnh của riêng bạn trong từng shell. Thanh bên cho biết ai đang chạy, đang hỏi hay đã xong.
cw converge status
Trial merge chạy nền và cho thấy cái nào merge sạch và theo thứ tự nào. Rồi bạn land: cw land session api --yes.
Nhóm theo việc bạn đang làm. Mỗi thẻ một câu; giới hạn nằm sau một cú bấm.
Mỗi session là một git worktree và một branch riêng, có dải port và một shell của chính bạn.
Mỗi session có branch riêng, một dải port ($PORT), thư mục cache và tên database hoặc Docker tuỳ chọn. Gõ gì trong shell — claude, codex, một dev server — là việc của bạn.
Các lease chỉ mang tính hợp tác: một tiến trình phớt lờ chúng vẫn có thể đụng độ với session khác.
Viết prompt một lần và gửi cho nhiều session, có bản xem trước chính xác.
Viết prompt một lần, tuỳ chọn tinh chỉnh bằng chương trình bạn đặt tên, rồi gửi cho một hoặc nhiều session với bản xem trước chính xác. Chỉ bấm Enter khi bạn tick chọn.
Việc một session có chạy agent hay không chỉ là đoán; bản nháp chỉ nằm trong bộ nhớ.
Một cú bấm khởi động session với launcher, các terminal phụ và một trình duyệt trên port của nó.
Một preset khởi động session với launcher của nó, các terminal phụ mỗi cái chạy một lệnh, và một ngăn Browser trên port của session.
Các lệnh nằm trong file settings của riêng bạn, và không có gì chờ server sẵn sàng.
Một danh sách cho biết session nào đang chạy, đang hỏi hay đã xong, suy ra từ shell.
Mọi session nằm trên một danh sách và cho biết nó đang chạy, đang chờ bạn, đã xong hay thất bại — suy ra từ chính shell, không cần cấu hình gì.
Suy ra từ chữ trên màn hình, output và cây tiến trình: đáng tin với Claude Code, Codex và Gemini, chỉ gần đúng với các agent khác. cw hooks install claude (hoặc codex) làm chúng chính xác ở những chỗ agent báo cáo.
Phần cuối log lỗi, các dòng lỗi, lỗi console và diff trong một ngăn, sẵn để gửi.
Ngăn Debug gom phần cuối log test lỗi, các dòng lỗi, lỗi console của các ngăn trình duyệt và diff, rồi soạn sẵn để bạn gửi. cw debug in một bộ tương tự (kết quả check, lỗi của terminal, diffstat và những lời cuối của agent) để bạn dán cho một AI.
Nhận diện dòng lỗi và che secret chỉ là heuristic, không phải đảm bảo.
Cho agent đọc hoặc điều khiển một ngăn trình duyệt: mặc định tắt, và hỏi trước khi làm.
cw browser đọc và điều khiển một ngăn Browser sau công tắc Off, Read hoặc Control cho từng ngăn. Mặc định Off; điều khiển ngoài localhost, và chạy một đoạn script ở bất cứ đâu, đều hỏi bạn cho từng lệnh.
Chữ trên trang có thể mang chỉ thị độc hại và được đánh dấu là không tin cậy; công tắc theo từng ngăn và không bao giờ được nhớ.
Trial merge chạy nền cho thấy cái nào merge sạch và theo thứ tự nào; cw land dựa trên bằng chứng đó.
Các trial merge chạy nền cho biết session nào merge không xung đột và theo thứ tự nào, và cw land dựa trên bằng chứng đó.
Bằng chứng chỉ có giá trị với base commit mà nó được thử, nên sau một lần land các session còn lại hiện unknown cho đến khi được thử lại. Nó cho thấy xung đột chứ không đảm bảo đúng đắn, và --force có thể land khi bằng chứng chưa đủ.
Thay đổi của hai session cạnh nhau, file chung được đánh dấu, kèm kết quả test mỗi bên.
Thay đổi đã commit của hai session cạnh nhau, các file chung được đánh dấu, kèm kết quả test mỗi bên và nút Land riêng.
Chỉ công việc đã commit, và hai session cùng đụng một file không có nghĩa là xung đột.
Một commit git ẩn quanh mỗi lượt của agent được nhận diện: xem nó đổi gì, lấy lại file.
Khi một agent được nhận diện bắt đầu và kết thúc một lượt, crossweave ghi worktree thành một commit git ẩn. Xem lượt đó đã đổi gì, hoặc lấy lại các file; khôi phục luôn chạy thử trước và để lại một điểm quay về.
Cần session có worktree riêng và một agent được nhận diện; ranh giới lượt là suy đoán và một checkpoint tự động có thể bị bỏ qua; file bị ignore không được ghi; giữ 50 checkpoint mới nhất. Checkpoint là đối tượng git trong repository của bạn, thấy được bằng git log --all và git push --mirror, và chứa cả file không bị ignore như secret.
Bấm vào một dòng diff, viết ghi chú, và các ghi chú được dán vào shell của session.
Bấm vào một dòng trong ngăn Changes hoặc một checkpoint, viết ghi chú, và các ghi chú được dán vào shell của session thành một khối. Không có gì tự bấm Enter thay bạn.
Comment chỉ nằm trong bộ nhớ, và một shell thường không có agent sẽ bị từ chối.
Bật lên: lệnh test đã tin cậy chạy khi agent kết thúc lượt, và lỗi có thể báo cho bạn.
Bật lên thì lệnh test bạn đã tin cậy sẽ chạy khi một agent kết thúc lượt có đổi file. Khi lỗi, có thể gửi vào shell (đã che secret) và có thông báo desktop không bao giờ hiện output.
Mặc định tắt. Việc một lượt kết thúc là suy đoán nên một lần chạy có thể bị bỏ sót hoặc lặp lại. Nó chạy code agent vừa viết, ngoài mọi sandbox, cho mọi project bạn đã tin cậy lệnh; thông báo đến từ cửa sổ đang mở nên chỉ project nó đang mở mới báo.
Giới hạn đầy đủ trên GitHub · Giới hạn đầy đủ trên GitHub (2)
File secret, CI, migration và dependency được gắn nhãn, và Land hỏi trước với secret và CI.
File có tên giống secret, cấu hình CI và hook, migration và manifest dependency mang một nhãn trong Changes, Checkpoints và Compare, và nút Land của Cockpit hỏi trước với file giống secret và file automation.
Chỉ dựa vào tên file: có thể bỏ sót một key dán vào file thường và gắn nhãn nhầm file vô hại. cw land và Land all ready không hỏi, và câu hỏi bị bỏ qua nếu không đọc được diff.
Một session mới có thể khởi động bằng một launcher — hoặc chỉ là một shell.
Hoặc wrapper của riêng bạn (cx, một script, một dev server). crossweave không chọn hay cấu hình agent: một launcher gõ lệnh bạn đã lưu vào shell của session rồi chạy nó, và bạn cũng có thể bắt đầu bằng một shell thường.
| Làm tay (git worktree + tmux) | crossweave | |
|---|---|---|
| Một branch và một bản checkout cho mỗi agent | Bạn tự tạo và xoá từng worktree. | cw session new tạo worktree và branch; cw gc thu hồi những gì đã kết thúc. |
| Port, cache, database | Tuỳ bạn nhớ mà đặt. | Mỗi session một dải port, một thư mục cache và tên database hoặc Docker tuỳ chọn (mang tính hợp tác, không ép buộc). |
| Ai đang cần bạn | Lật qua từng cửa sổ. | Một thanh bên: đang chạy, đang hỏi, đã xong hoặc thất bại. Trạng thái được suy ra từ hoạt động của terminal; độ chính xác tuỳ agent. |
| Merge cái nào trước | Tuỳ phán đoán của bạn. | Trial merge cho thấy cái nào merge sạch và một thứ tự đề xuất. Chúng cho thấy xung đột, không đảm bảo đúng đắn. |
| Bản ghi từng lượt của agent | Reflog, nếu bạn có commit. | Mỗi lượt được nhận diện một checkpoint để xem và khôi phục (v0.6.0). |
crossweave thêm một daemon và một ứng dụng vào quy trình trên; nếu bạn chỉ chạy hai agent, worktree thường là đủ.
0.6.0 makes the loop with an AI agent safer and faster without choosing or configuring the agent for you: a checkpoint around every agent turn you can look at and…
0.5.0 gives the cockpit a Settings page in the manner of Cursor's and a Dashboard that shows what your projects and sessions cost in disk and memory — and proposes,…
0.4.0 is the release where the cockpit and the shell talk to each other, and where running several agents at once gets easier to supervise: a session can say it is done,…
Một công cụ ưu tiên chạy cục bộ để chạy nhiều session trên một repository rồi land chúng về. Một session là một git worktree cộng một shell trong đó, như một cửa sổ tmux có branch riêng. Một daemon chạy nền (cwd) lo phần sổ sách; cw, một dashboard terminal và ứng dụng Cockpit nói chuyện với nó.
Không. Nó có ngăn xem file gọn nhẹ và ngăn diff, nhưng không cố thay editor của bạn. Cmd+click mở file trong editor bạn chọn.
Bất cứ thứ gì bạn chạy được trong shell. Có launcher cho Claude Code, Codex, Gemini CLI, OpenCode, Cursor Agent, Copilot CLI, Aider, Amp và Qwen Code, và bạn thêm được launcher riêng. Dấu hiệu trạng thái đáng tin nhất với Claude Code, Codex và Gemini.
Không. Bạn chọn một launcher, hoặc một shell thường, và tự sửa lệnh của từng launcher trong Settings. Khởi động session bằng launcher sẽ gõ lệnh đã lưu đó vào shell và chạy nó. crossweave không chọn, không cấu hình và không giám sát agent.
Bản thân crossweave không gửi gì đi đâu và không có telemetry: một daemon cục bộ sau một unix socket. Nó chỉ dùng mạng khi installer tải về, khi cw update, và khi kiểm tra bản mới tuỳ chọn với GitHub. Lệnh Refine là chương trình bạn đặt tên, còn các agent bạn chạy và các trang bạn mở có hành vi mạng riêng của chúng.
CLI, daemon và dashboard terminal chạy trên macOS (Apple Silicon và Intel) và Linux (x64). Ứng dụng Cockpit chạy trên macOS Apple Silicon. Windows không phải mục tiêu.
Miễn phí và mã nguồn mở theo giấy phép MIT.
Notarize cần tài khoản Apple Developer trả phí, mà tác giả chưa có. Vì vậy tải ứng dụng bằng trình duyệt sẽ gặp cảnh báo của macOS; đường cài bằng installer và các bước thủ công ở trang Tải về tránh hoặc gỡ được cảnh báo đó.
Chạy cw update. cw cũng tự kiểm tra bản mới ở nền (kết quả được lưu trong một ngày) và báo cho bạn khi có; cw config update-check off tắt việc đó.
Chỉ khi bạn bật (Settings → Checks, mặc định tắt) và chỉ với lệnh test bạn đã tin cậy bằng cw config trust. Nó chạy code agent vừa viết, ngoài mọi sandbox.
Thoát ứng dụng, dừng daemon của từng project bằng cw daemon stop, xoá các session không còn cần, rồi xoá các file đã cài. Các bước chính xác, theo đúng thứ tự, nằm trong tài liệu cài đặt.
CLI và daemon làm được mọi thứ; Cockpit là giao diện desktop trên chúng, chạy trên macOS Apple Silicon. Trên Linux, hoặc khi không dùng ứng dụng, hãy dùng cw và dashboard terminal (cw tui).
Nó merge phần việc đã commit của session vào branch gốc trong checkout chính của bạn, mặc định dạng squash (merge và rebase cấu hình được). Checkout phải sạch, session đang chạy cần --force, và xung đột sẽ dừng lại. Sau đó worktree và branch của session bị xoá, nên mọi thứ chưa commit trong worktree đó không được giữ lại.
IDE có agent là một trình soạn thảo với agent bên trong. crossweave là lớp nằm dưới các công cụ của bạn: cho mỗi công cụ một worktree và shell cô lập, cho thấy trạng thái của chúng và land phần việc của chúng. Nó không thay trình soạn thảo hay chọn agent thay bạn.
Một worktree dùng chung kho đối tượng của repository, nên nó chứa file làm việc của bạn chứ không phải một bản sao lịch sử khác. Thứ phình ra là các dependency cài riêng cho từng worktree (node_modules). Dashboard cho thấy ổ đĩa mỗi session chiếm (là cận dưới khi phép đo còn đang chạy), và cw gc thu hồi các session đã kết thúc.
Các agent của bạn chạy như những sợi dọc song song. crossweave là sợi ngang: sợi chéo buộc chúng lại để tấm vải đứng vững.
Hai worktree, hai shell, một thanh bên. Làm theo phần bắt đầu nhanh.