Aki Dev Sync
macOS · Tauri v2Đồng bộ code Local ↔ Remote, giám sát quota AI
github.com/lacvietanh/aki-dev-sync · Công cụ dev
Giải đúng một việc
"Code ở một máy, để AI làm ở máy khác — mà không phải commit rác chỉ để chuyển file." — Aki Dev Sync giữ một môi trường phát triển tách đôi luôn đồng bộ: bạn code và commit ở máy local, đẩy lên server cho AI xử lý, rồi kéo kết quả về review.
Mô hình Local ↔ Remote
LOCAL — Nguồn sự thật
Giữ lịch sử Git. Bạn review, commit và chỉnh sửa trong IDE cá nhân (ví dụ Antigravity).
REMOTE — Xưởng AI
Một server mạnh hơn truy cập qua SSH, nơi AI (Claude Code / Claude MAX) đọc toàn bộ ngữ cảnh và sinh code.
PUSH đẩy thay đổi local lên để AI thấy đủ; PULL kéo phần AI vừa làm về để review và commit — khép kín vòng lặp.
Tính năng
PUSH / PULL qua rsync
Đẩy thay đổi local lên remote và kéo phần AI vừa làm về. Bật/tắt kèm .git để cho AI nhận đủ lịch sử dự án. Có chế độ DRY RUN xem trước trước khi ghi.
Đẩy file chọn lọc (SELECT)
Chọn đúng các file đã thay đổi từ Git status (Modified / Untracked / Deleted) và chỉ đẩy những file đó — không cần quét cả cây thư mục.
Giám sát quota thật
Số quota thật, không ước lượng: Claude Code (remote) đọc rate_limits 5 giờ / 7 ngày; Antigravity (local) đọc từ Language Server của IDE. Kèm đếm ngược reset.
Mở nhanh (Open Popup)
Một menu mở dự án: Local (Finder, Terminal, VSCode, Antigravity) và Remote qua SSH (Terminal, VSCode Remote, Antigravity Remote). IDE chưa cài sẽ tự làm mờ.
Tự động làm mới nền
Tự kiểm tra git status, độ lệch giữa hai bên và quota AI ở chế độ nền; nút PUSH/PULL tự sáng khi hai bên lệch nhau. Vòng đếm ngược hiển thị tiến độ làm mới.
Tiện ích dev
Sửa ~/.ssh/config ngay trong app (có undo/backup), modal Git hợp nhất (status, commit log, commit-and-push), preset rsync excludes (Nuxt 4 / Tauri v2), và hook trước/sau mỗi lần sync.
Bên dưới nắp capo
Quota thật, không đoán mò
Claude Code phát rate_limits sau mỗi lượt; app vá idempotent statusline-command.sh qua SSH để con số luôn là sự thật từ server, không phải ước lượng token.
Sống sót lúc cháy quota 100%
Khi chạm giới hạn, Claude CLI bỏ luôn khối rate_limits (lỗi 429) làm thanh tiến độ biến mất. App tự ghim 100% và giữ thời điểm reset cuối — UI không vỡ đúng lúc bạn cần nhìn nhất.
Đọc quota Antigravity từ local
Endpoint cloud trả 0% vô dụng; thay vào đó app đọc thẳng Language Server cục bộ của IDE: quét process, lấy CSRF token, tìm cổng qua lsof rồi gọi RPC GetUserStatus — thuần JS, ~40ms.
Công nghệ
Tác giả
Lạc Việt Anh — Người tự học, tự đam mê và tự tay xây dựng các dự án trong hệ sinh thái Aki. Aki Dev Sync sinh ra từ chính cách làm việc hằng ngày của anh: code ở local, để AI chạy trên server.
Trong hệ sinh thái AkiTao
Aki Dev Sync là công cụ dev trong hệ sinh thái AkiTao.com. Cùng với AkiClaudeDoc (baseline rule/skill cho Claude Code) và AkiDEV (tri thức kỹ thuật), đây là bộ công cụ phản ánh cách Aki làm việc với AI hằng ngày.
Câu hỏi thường gặp
Aki Dev Sync là gì?
Aki Dev Sync là app macOS (xây bằng Tauri v2) giúp đồng bộ code giữa máy local và server remote qua rsync và ssh. Bạn code ở máy local (nơi giữ Git và IDE), đẩy lên server cho AI (Claude Code) xử lý, rồi kéo kết quả về để xem lại và commit. App còn giám sát quota của Claude Code và Antigravity theo thời gian thực.
Mô hình Local ↔ Remote hoạt động ra sao?
LOCAL là "nguồn sự thật": giữ lịch sử Git, là nơi bạn review và commit trong IDE (ví dụ Antigravity). REMOTE là "xưởng AI": một server mạnh hơn truy cập qua SSH, nơi AI đọc toàn bộ ngữ cảnh dự án và sinh code. PUSH đẩy thay đổi local lên để AI thấy đủ; PULL kéo phần AI vừa làm về để review và commit — khép kín vòng lặp.
Cài đặt thế nào và cần gì?
Tải file .dmg mới nhất từ trang Releases trên GitHub (bản -arm cho Apple Silicon, -universal cho cả Intel). Bản build chưa ký nên lần đầu mở cần chuột phải → Open. Yêu cầu: có sẵn rsync và ssh trên macOS (mặc định đã có) và một host SSH để kết nối.
Aki Dev Sync giám sát quota AI bằng cách nào?
Đây là số quota thật, không phải ước lượng. Với Claude Code (trên remote), app đọc trực tiếp rate_limits (cửa sổ 5 giờ và 7 ngày) mà chính Claude Code phát ra sau mỗi lượt. Với Antigravity (trên local), app đọc từ Language Server cục bộ của chính IDE. Có đếm ngược thời điểm reset cho từng nguồn.
Aki Dev Sync có mã nguồn mở không?
Toàn bộ mã nguồn công khai trên GitHub (github.com/lacvietanh/aki-dev-sync) để bạn đọc, build và tham khảo. Frontend dùng Vue 3 + Vite, backend dùng Rust + Tauri v2, lõi đồng bộ dùng rsync và ssh gốc của hệ thống.
Code ở local, để AI làm ở remote — đồng bộ trong một cú nhấn.
Tải Aki Dev Sync