GitHub Trending tuần này có một công cụ khá đúng nhu cầu của người quen review code trong terminal: tuicr. Nó gom toàn bộ diff thành một luồng liên tục, cho phép gắn nhận xét ngay tại dòng và xuất review sang GitHub, GitLab, Bitbucket hoặc Markdown.
Điểm đáng chú ý không nằm ở chữ “TUI” cho vui. tuicr cố giải quyết khoảng trống giữa git diff rất nhanh nhưng khó ghi chú, và giao diện web đầy đủ nhưng làm đứt nhịp bàn phím. Bài này kiểm tra repo trên Windows trước khi kết luận công cụ hợp với ai.
Mục lục [Hiển thị]
tuicr làm được gì khác git diff?
Ở chế độ local, lệnh tuicr -w mở các thay đổi chưa commit; tuicr -r main..HEAD đọc một khoảng commit. Với pull request, tuicr pr 125 lấy diff và cho phép duyệt bằng j/k, chuyển file bằng {/}, gắn comment bằng c và đánh dấu phần đã review bằng r.
Review có thể được giữ giữa các phiên. Khi xong, :submit gửi nhận xét lên nền tảng tương ứng; phím y xuất một khối Markdown có đường dẫn file và số dòng. Luồng thứ hai khá tiện khi cần đưa nhận xét sang coding agent mà vẫn giữ được vị trí lỗi.
Kết quả chạy repo trên Windows
Repo được clone ở commit hiện tại ngày 14/08/2026 và chạy bằng Rust 1.95.0 với cargo test --locked. Tổng cộng có 1.463 test: 1.459 pass, 2 fail và 2 ignore. Thời gian chạy phần test sau khi biên dịch là 4,30 giây.
Hai test thất bại đều nằm trong persistence::storage. Assertion mong chuỗi đường dẫn có /sessions/, trong khi Windows trả về \sessions\. Đây là lỗi giả định separator trong test, không phải bằng chứng rằng phiên review bị mất; tuy vậy nó cho thấy dự án vẫn còn một góc Windows cần làm sạch.
Cài và bắt đầu bằng phạm vi nhỏ
README đưa ra nhiều cách cài: binary dựng sẵn, Homebrew, Cargo, Mise và Nix. Trên Windows, cách ít vòng nhất là tải binary từ trang Releases, kiểm tra checksum rồi đặt file thực thi vào PATH. Cài bằng Cargo cũng được, nhưng sẽ phải chờ biên dịch toàn bộ dependency.
tuicr -w
tuicr -r main..HEAD
tuicr --stdout > review.mdNên thử trước với một branch nhỏ có 2-3 file. Sau khi quen luồng điều hướng và comment, mới bật gửi review thật. GitHub yêu cầu gh đã đăng nhập; GitLab dùng glab. Không nên đưa token trực tiếp vào file cấu hình hoặc lịch sử shell.
Chỗ tuicr đáng dùng và chỗ chưa thay thế được web
| Tình huống | Đánh giá |
|---|---|
| Review thay đổi local trước commit | Rất hợp, mở nhanh và không rời terminal |
| PR nhiều file, cần comment đúng dòng | Hợp nếu đã quen phím Vim |
| Xem CI, conversation và preview giao diện | Giao diện web vẫn đầy đủ hơn |
| Đưa review có cấu trúc cho agent | Xuất Markdown là điểm mạnh rõ ràng |
So với bài Superfile trong terminal, tuicr hẹp hơn nhưng bám rất sát một công việc: đọc diff và để lại nhận xét. Nó cũng bổ sung tốt cho bước security review trước commit; một bên rà bằng công cụ tự động, một bên buộc người review đọc thay đổi theo ngữ cảnh.
Lưu ý khi review repository của công ty
tuicr đọc diff local và có thể gọi CLI của nền tảng để gửi comment. Vì vậy quyền của gh, glab hoặc token Bitbucket vẫn là ranh giới bảo mật chính. Chỉ cấp scope cần cho review, tránh token quản trị và kiểm tra kỹ remote trước lần :submit đầu tiên. Chế độ xuất Markdown hoặc clipboard phù hợp hơn khi muốn đọc thử mà chưa cho phép công cụ ghi lên pull request.
File session lưu nhận xét giữa các lần mở cũng có thể chứa đoạn code hoặc tên file nội bộ. Trên máy dùng chung, cần xem vị trí dữ liệu trong thư mục cấu hình người dùng, quyền truy cập file và chính sách dọn session. Repository có secret xuất hiện trong diff thì vấn đề không nằm ở giao diện review; secret phải được thu hồi và xóa khỏi lịch sử theo quy trình riêng.
Trên Windows, hai lỗi test separator vừa ghi nhận chưa làm hỏng lệnh chính, nhưng nên thử với một repo không nhạy cảm trước. Kiểm tra ba thao tác tối thiểu: mở thay đổi chưa commit, đóng rồi mở lại session, sau đó xuất Markdown ra stdout. Nếu đường dẫn file và số dòng vẫn đúng, mới nối tiếp với tài khoản GitHub thật.
Một cấu hình khởi đầu vừa đủ
tuicr có nhiều theme, chế độ diff và phím tùy chỉnh, nhưng cấu hình ban đầu chỉ cần chọn light/dark, unified hay side-by-side và bật chuột nếu chưa quen hoàn toàn với Vim. Side-by-side hợp màn hình rộng; unified dễ đọc hơn trên laptop hoặc terminal chia đôi. Đừng chỉnh cả bảng phím trước khi dùng một vòng review thật, vì lúc đó mới biết thao tác nào thực sự gây chậm.
Kết luận
tuicr đáng thử khi phần lớn công việc đã ở terminal và review thường bị ngắt bởi việc chuyển cửa sổ. Điểm cộng là diff liên tục, comment theo dòng và đầu ra Markdown; điểm cần lưu ý là phím tắt có độ học nhất định và bộ test hiện còn hai lỗi separator trên Windows. Repo test đã được xóa sau khi ghi nhận kết quả.
