Aki Dev Sync: app macOS đồng bộ code local-remote
Đồng bộ code hai chiều qua rsync/ssh giữa máy local và remote, theo dõi quota thật của Claude Code và Antigravity, không cần commit rác chỉ để chuyển file.
Aki Dev Sync là app macOS (Apple Silicon và Intel) đồng bộ code hai chiều giữa máy local và một server remote qua rsync và ssh, đồng thời hiển thị quota thật của Claude Code và Antigravity ngay trong app. App giữ máy local làm nguồn sự thật cho Git, đẩy code lên remote cho AI agent xử lý, rồi kéo kết quả về để bạn review và commit. Không có commit rác nào chỉ để chuyển file giữa hai máy.
Aki Dev Sync là gì, và vì sao không nên commit code chỉ để đồng bộ máy?
Chạy AI agent như Claude Code trên một server mạnh hơn máy cá nhân là lựa chọn hợp lý, nhưng việc chuyển code qua lại giữa hai máy thường bị giải quyết theo cách tệ nhất: commit tạm, push, pull, rồi xóa commit đó. Lịch sử Git đầy rác, và mỗi lần AI sinh code trên remote lại thêm một vòng dọn thủ công.
Aki Dev Sync thay cả vòng đó bằng PUSH/PULL rsync trực tiếp. PUSH đẩy source code từ local lên remote (mặc định gồm cả .git/ để AI đọc đủ lịch sử). PULL kéo phần AI vừa sinh ra về local, và bạn xem trước bằng DRY RUN rồi mới commit. Máy local không đổi vai trò nguồn sự thật, remote chỉ là nơi chạy việc.
Các bản 1.26 đến 1.28: từ tiện ích đồng bộ đến app dùng được cả ngày
- ◆1.26.0 (17/08/2026): phím tắt F1/F2/F3 đổi chế độ xem cửa sổ, preset Ultra 1400px cho màn hình rộng, và một Donate modal.
- ◆1.27.0 (18/08/2026): thêm F12 ghim cửa sổ luôn ở trên cùng, và F2 thành nút chuyển qua lại giữa Ultra và Narrow.
- ◆1.28.0 (19/08/2026): thêm Glass Effect toggle; chuyển thư mục dữ liệu sang
~/.aki/devsync/với cơ chế tự di trú đã kiểm chứng trên máy thật, người dùng cũ không cần làm gì; hạ mức dùng GPU khi rảnh từ khoảng 95% xuống khoảng 25%; sửa để F1–F3 vẫn hoạt động khi đang gõ trong terminal tích hợp; và chặn biến môi trườngCLAUDE_CODE_CHILD_SESSIONcủa phiên cha rò vào các shell con mà app mở ra. - ◆1.28.1 (20/08/2026): sửa ⌘C để copy được vùng chọn trong terminal tích hợp, và các phím tắt tab lặp lại được thay vì chỉ ăn một lần.
Vì sao bản 1.28.0 quan trọng hơn một bản vá thông thường?
Ba sửa đổi của 1.28.0 xử lý ba vấn đề khác nhau của một app chạy cả ngày. Về GPU, hiệu ứng blur backdrop-filter trên các phần giao diện luôn hiện là nguồn tốn GPU rảnh lớn nhất; nó giờ tắt mặc định và chỉ bật lại qua Glass Effect. Con số ~95% xuống ~25% đo bằng GPU History của Activity Monitor trên Mac của tác giả. Về phím tắt, xterm từng nuốt các phím chức năng trước khi app kịp xử lý; giờ F1–F3 và F12 tới được app khi terminal đang ở màn hình shell thường, còn chương trình toàn màn hình như vim hay htop vẫn nhận phím như cũ. Về biến môi trường, portable-pty mặc định kế thừa toàn bộ môi trường của tiến trình cha, nên khi app khởi chạy từ trong một phiên Claude Code, CLAUDE_CODE_CHILD_SESSION=1 lọt vào mọi tab terminal và âm thầm tắt việc lưu transcript của mọi CLI claude chạy trong đó.
Cơ chế tự di trú sang ~/.aki/devsync/ đã được kiểm chứng trên máy thật trước khi phát hành: sao chép từng file, chỉ xóa nguồn khi bản sao thành công, và lần mở thứ hai không làm gì. Một thay đổi hạ tầng dữ liệu không nên bắt người dùng tự chuyển file.
Đo quota AI thật, không ước lượng token
Với Claude Code, app đọc rate_limits (cửa sổ 5 giờ và 7 ngày) do chính CLI của Anthropic phát ra qua hook statusLine sau mỗi lượt, trên máy local hoặc qua SSH tới host remote. Khi bạn chạm giới hạn, CLI bỏ hẳn khối rate_limits, nên script của app gộp mốc reset đã biết gần nhất và ghim 100% để thanh tiến độ không biến mất đúng lúc bạn cần nó.
Với Antigravity, app không gọi endpoint đám mây của Google (chúng trả về dữ liệu 0% giả). Thay vào đó nó đọc Language Server cục bộ của Antigravity: quét bảng tiến trình tìm binary, lấy CSRF token, tìm cổng đang lắng nghe bằng lsof, rồi gọi Connect RPC GetUserStatus, mất khoảng 40ms.
Đi kèm là Statusline Customizer: dựng trực quan một script statusline dùng chung cho Claude Code CLI và Antigravity CLI, chọn field, kéo thả để sắp xếp, tô màu theo thang 5 bậc, rồi đẩy tới máy local và mọi host SSH đã cấu hình.
Cài đặt và yêu cầu
Tải file .dmg mới nhất từ trang Releases trên GitHub: Aki-DevSync-vX.X.X-arm.dmg cho Apple Silicon, bản -universal.dmg cho cả Intel lẫn Apple Silicon. Mở file .dmg và bấm đúp Install (double-click + password).command: script chép app vào Applications, gỡ quarantine, ký ad-hoc rồi mở app, và chỉ hỏi mật khẩu khi chép thường không được phép.
Yêu cầu tối thiểu: rsync và ssh có sẵn trong PATH (macOS cài sẵn), cộng một host SSH bạn đã có quyền truy cập. Mã nguồn Vue 3 và Rust/Tauri v2 công khai trên GitHub.
Menu của app có mục cài AkiDevRule, bộ rule điều phối AI agent mà Aki Dev Sync dùng khi phát triển (changelog 1.26.0 dẫn thẳng agent.C3 và coding.B4). Xem thêm aki-mcp-sv, MCP server cùng hệ sinh thái Aki mở filesystem và shell của máy cá nhân cho AI web.