Aki Dev Sync
Trạm điều khiển trung tâm cho môi trường phát triển phân tán. Giữ code ở local, đẩy tác vụ nặng lên remote qua SSH, đồng bộ hai chiều bằng thuật toán baseline snapshot mà không làm bẩn git. Tích hợp giám sát quota AI bằng local RPC & cache hook, cùng bộ công cụ quản lý dự án native.
Push-only & Mirror Delete
Đẩy bộ source code cục bộ lên máy chủ remote để AI agent xử lý, sau đó thu hồi mã code đã sinh thành phẩm về. Ứng dụng cung cấp bảng điều khiển DRY RUN mạnh mẽ giúp dự đoán chính xác từng byte. Đặc biệt là khả năng biến .git/ thành push-only path: file lịch sử đẩy lên giúp AI có ngữ cảnh, nhưng bị chặn chiều kéo về để vĩnh viễn xóa bỏ bẫy mtime (thay đổi index ngầm) làm nút Sync báo hiệu giả. Chế độ xóa gương bảo vệ an toàn tối đa để không vô tình PUSH đè lên code của AI.
Baseline snapshot hai chiều
Rsync bị mù trạng thái (stateless): khi file X có ở máy A nhưng vắng ở B, nó không biết ai vừa xóa. Lỗ hổng này được xử lý bằng baseline snapshot bằng kiến trúc baseline snapshot disambiguation. Sau mỗi vòng đồng bộ thành công, ứng dụng ghi một ảnh chụp (baseline snapshot) vào file JSON local. Lần sau, nó đối chiếu ảnh chụp này để phân biệt được ngay file X là do bạn xóa ở local (chấp nhận) hay tạo mới ở remote (loại bỏ), giúp đối chiếu trạng thái theo snapshot.
Quota Claude Code
Loại bỏ hoàn toàn công nghệ ước tính token mập mờ. Hệ thống triển khai lõi Hybrid Patching chọc sâu qua SSH đọc trực tiếp bảng rate_limits ngầm (cửa sổ 5h và 7d) từ cache của Anthropic CLI. Kỹ thuật tiêm bash+jq giúp xử lý lỗi HTTP 429 tinh vi, duy trì hiển thị số liệu ngay cả khi tài khoản bị khóa cứng (quota exhaustion) thay vì làm sập UI.
Local RPC Antigravity
Đọc usage Antigravity từ local Connect RPC sau khi phát hiện process và port của IDE; không phụ thuộc vào dịch vụ quota trung gian.
Git & Smart Launcher
Tab Git Panel tích hợp một bộ Regex ANSI Parser giải mã mã màu terminal gốc kết hợp xem trước changelog qua sơ đồ Mermaid. Trình mở dự án Smart Open tự động phân tích các file cấu hình package (package.json, Nuxt, Tauri) để tự động sinh ra các nút chạy DEV và BUILD một chạm, gọi thẳng Terminal hệ thống macOS vô cùng tinh vi.
UX Đẳng cấp
Khối kiến trúc Monolithic Unit-of-Work Controller gộp mọi trigger kiểm tra trạng thái để triệt tiêu lỗi overlapping. Danh sách công việc áp dụng kiến trúc CSS Zero-JS Textarea tự động phình to hoàn hảo không dính lag ResizeObserver. Trình Statusline Customizer cho phép dựng HTML5 cấu hình bash với dải màu 5 cấp độ chỉ bằng thao tác kéo thả, giờ đây triển khai đồng thời cho cả Claude Code lẫn Antigravity CLI (AGY) từ một cấu hình duy nhất, hai CLI dùng chung đúng một bản script thay vì hai bản riêng dễ lệch nhau.
Cơ chế hoạt động & Bộ công cụ đi kèm
Mô hình Local là nguồn sự thật, Remote là nơi AI làm việc
Lịch sử git bảo mật tuyệt đối nằm ở máy local, nơi bạn thực hiện review kỹ lưỡng và commit. Trái lại, máy remote qua SSH đóng vai trò là "công xưởng", nơi AI agent (Claude Code, Claude MAX) trực tiếp đọc toàn bộ ngữ cảnh khổng lồ của project và sinh code ở quy mô hàng ngàn dòng. Nút PUSH đẩy mọi thay đổi (bao gồm .git/ để AI thấm nhuần lịch sử codebase) lên remote. Nút PULL sẽ thu gom toàn bộ kết quả mà AI vừa vắt kiệt sức lực tạo ra, mang trở lại local để bạn audit trước khi commit, hoàn thành vòng đời luân chuyển khép kín không tì vết.
Sức mạnh kỹ thuật & Quản lý dự án
- Unit-of-Work Controller: Khối kiến trúc nền tảng siêu việt gộp mọi yêu cầu refresh luồng dữ liệu (bất kể từ chu kỳ ngầm, click thủ công, hay lưu cấu hình) vào một hàm độc nhất, dùng generation token để triệt tiêu hiện tượng chồng lấp tiến trình (overlapping), giữ trạng thái spinning theo đúng vòng đời xử lý.
- Zero-JS Textarea: Ghi chú dự án và Global Note dùng
field-sizing: contentđể tự động giãn theo nội dung, không cần logic resize riêng bằng JavaScript. - Smart Open Popup: Trình khởi chạy không giới hạn ở shortcut đơn thuần, mà là một analyzer engine thực thụ tự động quét đệ quy các tập tin lockfile (Nuxt/Node/Tauri) để nội suy và động hóa sinh ra các lệnh DEV/BUILD một chạm, bắn thẳng vào Terminal cục bộ hoặc qua đường hầm SSH.
- Regex ANSI Git panel: Vứt bỏ các bảng mã mờ nhạt, bộ parser Regex hạng nặng chạy trên client sẽ bắt mã màu gốc của terminal (giải mã escape code) và hiển thị log Git với màu sắc nguyên bản, đồng thời hỗ trợ Unicode tiếng Việt hoàn hảo nhờ tiêm cấu hình
core.quotepath=false. - SSH Config Editor & Hooks: Trình soạn thảo file SSH có lồng ghép cơ chế safety net tự động tạo file backup trước khi lưu. Đi kèm với nó là kiến trúc chạy script vỏ Pre/Post Hook kẹp chặt hai đầu vòng đời đồng bộ rsync, mở ra tiềm năng kích hoạt container Docker tự động.
Ghim workspace: một Desktop macOS cho mỗi project
Ghim cứng cửa sổ Tauri xuyên thấu qua mọi Desktop/Space (Không gian làm việc) của macOS. Bằng cách trang bị các preset tái cấu trúc kích thước chuẩn milimet (như Narrow hẹp, Stick Top-Left cố định góc chết, hoặc Center Primary căn giữa), ứng dụng biến thành một bảng điều khiển trung tâm bất di bất dịch, cho phép bạn trượt qua lại giữa hàng chục dự án lớn nhỏ mà vẫn luôn kiểm soát được trạng thái đồng bộ và quota AI của tất cả các project ở đúng một vị trí quen thuộc trên màn hình. Các preset bố cục này giờ đây có thể gán phím tắt F1/F2/F3 và tự động ghi nhớ vị trí, kích thước bạn chọn, khôi phục nguyên trạng ngay ở lần mở app kế tiếp thay vì phải chọn lại từ đầu mỗi lần khởi động. Xem chi tiết workflow không gian macOS này.
Không đi qua server trung gian
Aki Dev Sync đồng bộ dữ liệu qua đường hầm mã hóa rsync và ssh nguyên bản, kết nối trực tiếp đến host SSH do bạn cấu hình. Không có một dòng lệnh nào (zero code) gửi lén mã nguồn hay quota của bạn qua bất kỳ server proxy trung gian nào của tác giả hay dịch vụ bên thứ ba.
Câu Hỏi Thường Gặp
Aki Dev Sync giải quyết vấn đề gì?
Giữ đồng bộ code giữa một máy local (nơi bạn review/commit) và một máy remote (nơi bạn chạy build hoặc để AI agent làm việc), mà không tạo commit rác chỉ vì phải chuyển file qua lại.
Aki Dev Sync có miễn phí và mã nguồn công khai không?
Mã nguồn công khai tại github.com/lacvietanh/aki-dev-sync. Vì file giấy phép không nằm cố định một chỗ và có thể thay đổi theo thời gian, hãy kiểm tra giấy phép mới nhất trực tiếp trên trang GitHub trước khi dùng cho mục đích thương mại.
Aki Dev Sync chạy trên nền tảng nào?
Chỉ macOS, bản Universal chạy được trên cả chip Apple Silicon và Intel. Không có bản Windows hay Linux.
Máy remote có bắt buộc phải chạy Claude Code không?
Không bắt buộc cho phần đồng bộ file (PUSH/PULL hoạt động độc lập với AI agent nào đang chạy). Riêng tính năng giám sát quota AI hiện hỗ trợ sâu cho Claude Code và Antigravity, các agent khác vẫn dùng được máy remote bình thường qua SSH nhưng sẽ không có khung giám sát quota chuyên biệt.
Code của tôi có được gửi qua server bên thứ ba không?
Không. Aki Dev Sync đồng bộ trực tiếp qua rsync và ssh đến host SSH do chính bạn cấu hình, không đi qua server trung gian nào của tác giả hay bên thứ ba.
Có cần cài thêm phần mềm gì để chạy được không?
Chỉ cần rsync và ssh, cả hai đều có sẵn trên macOS, cộng với một host SSH mà máy bạn kết nối tới được.
Statusline của Claude Code là gì?
Là dòng trạng thái hiển thị ở cuối phiên làm việc trong Claude Code CLI, thường cho biết thư mục hiện tại, model đang dùng, phần trăm context window còn lại và các thông tin vận hành khác, được sinh ra bởi một script bash do người dùng tự cấu hình.
Có bắt buộc cài cả app Aki Dev Sync để dùng statusline không?
Không. Script statusline đóng gói độc lập tại share/aki-statusLine/statusline.sh trong repo, chỉ cần copy vào ~/.claude/statusline-command.sh và khai báo trong ~/.claude/settings.json là dùng được, không cần cài app.
Hệ màu 5 bậc trong Statusline Customizer nghĩa là gì?
Là 5 mức màu theo độ khẩn cấp của một giá trị phần trăm: xanh dương dưới 25%, xanh lá 25-55%, vàng 55-75%, cam 75-88%, đỏ từ 88% trở lên, dải màu hẹp dần khi mức độ khẩn cấp tăng lên.
Có đẩy cấu hình statusline lên máy remote được không?
Có. Statusline Customizer hỗ trợ áp dụng cấu hình cho máy local và/hoặc bất kỳ số lượng host SSH remote nào đã cấu hình cùng lúc, chỉ sửa một lần là cập nhật ở mọi nơi.
Desktop hoặc Space trên macOS là gì?
Là các không gian làm việc ảo riêng biệt trên cùng một màn hình vật lý, mỗi Space có thể chứa một bộ cửa sổ ứng dụng khác nhau, chuyển qua lại bằng thao tác vuốt ba/bốn ngón (Ctrl+swipe) hoặc phím tắt Control cộng mũi tên trái/phải, giúp tách biệt ngữ cảnh làm việc mà không cần nhiều màn hình vật lý.
Ghim cửa sổ xuyên Space có ảnh hưởng hiệu năng không?
Về bản chất đây chỉ là bật hai tùy chọn cửa sổ có sẵn của hệ điều hành (luôn ở trên cùng và hiển thị trên mọi không gian làm việc), không phải chạy thêm tiến trình nền nào mới, nên không tạo thêm tải xử lý đáng kể. Cửa sổ được nhìn thấy thường xuyên hơn có thể khiến bạn để ý các lần làm mới giao diện nhiều hơn, nhưng đó là do được thấy nhiều hơn, không phải do chạy nặng hơn.
Cách này có cần cài đặt gì thêm ngoài các preset kích thước cửa sổ không?
Không. Chỉ cần bật nút ghim (thumbtack) trên titlebar và chọn một trong các preset kích thước cửa sổ có sẵn trong menu app-icon (☰), không cần cấu hình gì thêm ở phía macOS hay trong project.
Bài viết liên quan
Aki Dev Sync Là Gì? App macOS Đồng Bộ Môi Trường Code Local-Remote
Aki Dev Sync là công cụ macOS của Lạc Việt Anh giúp đồng bộ môi trường phát triển (split environment), cho phép code ở cả hai máy mà không làm bẩn lịch sử git.
Aki Dev Sync: Tùy Biến Thanh Trạng Thái Claude Code
Bật tắt từng trường, kéo thả sắp xếp, chọn màu bằng swatch: Statusline Customizer biến việc chỉnh thanh trạng thái Claude Code thành thao tác kéo thả.
Quản Lý Nhiều Dự Án Qua Nhiều Desktop (Space) macOS Với Aki Dev Sync
Một mẹo làm việc thực tế: ghim Aki Dev Sync ở một góc màn hình cố định, xuyên qua mọi Desktop, để không bao giờ mất dấu project nào đang chờ push/pull.