Aki Dev Sync
macOS · Tauri v2 v1.28.0Đồng bộ môi trường phát triển phân tán (split environment), code trên cả 2 máy, không commit rác để chuyển file.
github.com/lacvietanh/aki-dev-sync · Công cụ dev
Điều khiển môi trường local ↔ remote
Aki Dev Sync không chỉ là một công cụ chép file, mà là một ứng dụng macOS (xây dựng bằng Rust Core và Tauri v2) sinh ra để vận hành trơn tru môi trường phát triển phân tán (split environment). Bằng cách khai thác tối đa sức mạnh rsync và ssh tích hợp sâu trong OS, ứng dụng chia cắt rõ ràng workflow của bạn: LOCAL giữ vai trò là "nguồn chính", nơi bạn giữ lịch sử Git, tiến hành review kỹ lưỡng và tinh chỉnh code bằng IDE Antigravity; trong khi đó, REMOTE đóng vai trò là "Xưởng công nghiệp nặng", một chiếc server mạnh mẽ để chịu tải các bản build khổng lồ, che giấu các key API cốt lõi, hoặc làm sân bãi chuyên dụng cho các AI agent (như Claude Code / Claude MAX) cày ải mã nguồn. Quá trình PUSH đẩy context ngữ cảnh lên remote và PULL thu hoạch thành quả code về local hoạt động theo baseline snapshot, không cần tạo commit chỉ để chuyển file. App cũng đọc quota Claude Code từ cache statusLine và quota Antigravity từ local RPC.
Giao diện thực tế
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.
REMOTE, xưởng AI
Một server mạnh hơn truy cập qua SSH, nơi AI như Claude Code đọc toàn bộ ngữ cảnh và sinh code ở quy mô lớn.
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 mà không cần commit rác chỉ để chuyển file.
Tính năng
Cơ chế PUSH/PULL (rsync) & Push-only Paths
Đồng bộ hai chiều toàn vẹn: Đẩ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ề để bạn tiến hành audit và commit. Ứng dụng cung cấp bảng điều khiển DRY RUN mạnh mẽ giúp bạn dự đoán chính xác từng byte thay đổi. Cấu hình đỉnh cao nằm ở khả năng biến thư mục .git/ thành push-only path: file lịch sử đẩy lên giúp AI tăng cường ngữ cảnh, nhưng bị chặn chiều kéo về để xóa bỏ bẫy mtime (thay đổi index ngầm) làm nút Sync báo hiệu giả.
Bảo Vệ Xung Đột (baseline snapshot, Conflict Table, Hooks)
Sở hữu module Select File thủ công tích hợp bảng Conflict Table phân tích cực sâu: so sánh thời gian chỉnh sửa (mtime) đến từng phần nghìn giây giữa local và remote trước khi ghi đè, chặn đứng thảm họa vô tình xóa code của AI. Chế độ xóa gương Mirror (--delete) được thiết kế đặc chủng theo dự án với cảnh báo an toàn ba lớp. Không những vậy, bạn có thể lập trình các Pre/Post hook script shell để tự động build docker hoặc bắn Slack webhook chạy kẹp quanh mỗi vòng đời rsync.
Hệ Thống Giám Sát Quota THẬT (Agent Usage)
Đọc dữ liệu quota từ nguồn hỗ trợ thay vì ước tính token. Với Claude Code, app đọc rate_limits từ cache statusLine của CLI trên local hoặc host SSH. Với Antigravity, app phát hiện Language Server và đọc dữ liệu từ local RPC. Hai nguồn quota được quản lý độc lập.
Statusline Customizer (Trình Tạo Bash UI)
Một cỗ máy sản xuất giao diện terminal thu nhỏ. Bạn có thể dựng cấu hình thanh trạng thái cho Claude Code CLI qua môi trường trực quan HTML5 : gạt nút ẩn hiện các biến (token, budget), sử dụng chuột kéo thả sắp xếp khối, và điều khiển dải màu động 5 cấp bậc cảnh báo mức độ cạn kiệt tài khoản. Toàn bộ thiết kế được render dưới dạng Live Preview, sau đó tự động tiêm thẳng vào máy local hoặc các host SSH đã cấu hình mà không cần chỉnh file bằng tay.
Smart Open Popup & Phân Tích Lockfile
Menu lệnh điều hướng cho các thao tác thường dùng. Tự động chia làn rành mạch: Truy cập Local (Finder, Terminal, quét tìm nhị phân của VSCode/Insiders/Antigravity) và Truy cập Remote qua hầm SSH (SSH Terminal, kích hoạt VSCode/AG Remote mode). Đặc biệt, hệ thống chứa engine 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 trong app.
Quản Lý Desktop & Ghim Cửa Sổ
Tính năng cho workflow nhiều project: ghim cửa sổ Tauri theo work area hiện tại của macOS. Các preset Narrow, Wide, Stick Top-Left và Center Primary giúp giữ bố cục cửa sổ nhất quán khi chuyển giữa các project.
Bộ công cụ tích hợp
Task list và ghi chú dùng textarea tự co giãn không cần logic resize riêng bằng JavaScript. Global Note tự lưu. Git Panel hiển thị ANSI color và preview changelog bằng Mermaid. SSH Config Editor có backup trước khi lưu.
Phù hợp với ai?
- Code trên máy nhẹ, chạy build và AI trên server mạnh hơn.
- Cần giữ phần lõi source code trên server remote của riêng mình.
- Chuyển đổi nhanh giữa nhiều máy mà không tạo commit rác trên GitHub.
- Muốn đưa nguyên project, kể cả .git/, cho AI agent đọc đầy đủ ngữ cảnh.
Nhiều dự án, nhiều Desktop macOS
Một cách tổ chức phổ biến trên macOS là dành riêng mỗi Desktop (Space) cho một project. Vấn đề là mỗi lần vuốt sang Desktop khác, bạn mất tầm nhìn vào các project còn lại. Ghim cửa sổ Aki Dev Sync (tính năng thật, có từ bản 1.11.0) giữ nó hiển thị và ở trên cùng xuyên suốt mọi Space, kết hợp preset kích thước Stick Top-Left hoặc Narrow để có một bảng điều khiển cố định ở một góc màn hình, dù đang đứng ở Desktop nào.
Bên dưới nắp capo
ANSI Terminal & Regex Code Parsing
Bộ giải mã regex siêu nhẹ (lightweight parser) chạy trực tiếp ngay tại máy khách client, có nhiệm vụ bắt và phân tách từng đoạn mã màu terminal escape code (như \x1b[32m), sau đó biên dịch chúng thành các thẻ HTML được style hóa (styled HTML). Điều này đảm bảo Git panel hiển thị log với màu sắc gốc sống động như terminal thật. Hơn nữa, nó xử lý triệt để bảng mã Unicode tiếng Việt bằng cách tiêm cấu hình core.quotepath=false, tránh lỗi hiển thị ký tự mã hóa lộn xộn trên giao diện UI.
Smart Stack Analyzer & Binary Detect
Công cụ khởi chạy không dừng lại ở mức shortcut. Nó sở hữu một cỗ máy phân tích (analyzer engine) quét đệ quy các tập tin nền tảng dự án và đọc sâu vào các file khóa phụ thuộc lockfile như pnpm-lock, yarn.lock, bun.lockb, npm. Nhờ đó, nó phán đoán chính xác và cấu trúc động lệnh DEV/BUILD (ví dụ: npm run tauri dev) để bung thẳng vào terminal macOS. Kèm theo đó là cơ chế phát hiện file nhị phân (binary detection) để làm mờ các IDE chưa được cài đặt (như VSCode Insiders).
Zero-JS Auto-growing CSS Architecture
Chấm dứt sự phụ thuộc vào các thư viện bên thứ 3 hoặc Javascript listener sự kiện thay đổi kích cỡ (resize) nặng nề vốn gây ra hiện tượng giật lag khung hình. Ứng dụng tiên phong áp dụng thuộc tính CSS thế hệ mới của engine WebKit: field-sizing: content. Tính năng này cho phép toàn bộ các ô nhập liệu (Textarea) ghi chú task và notepad tự động giãn nở chiều cao (auto-grow) ăn khớp theo baseline snapshot từng pixel với khối lượng chữ bạn gõ.
Hybrid Quota Patching & CLI Deep Read
Không dùng token ước lượng. Đọc thông số rate_limits (giới hạn 5h/7d) chính chủ bằng cách móc thẳng vào file cache statusLine sinh ra từ CLI của Anthropic. Đối mặt với bẫy lỗi HTTP 429 khi người dùng xài quá đà, hệ thống dùng kỹ thuật tiêm Hybrid Patching bằng bash script kết hợp jq để cứu lấy bảng dữ liệu, giữ cho giao diện UI tồn tại kiên cường bất chấp việc bạn chạm trần quota exhaustion (blackout).
JSON-RPC Antigravity Engine Port Scan
Công nghệ dịch ngược quota IDE tinh xảo: Thay vì gọi server bên ngoài, nó tung ra một lệnh quét toàn diện Process Table cấp độ hệ điều hành bằng công cụ lsof để săn tìm cổng TCP cục bộ mà Language Server của IDE đang cư trú. Ngay sau đó, nó phóng ra một gói tin giao thức HTTP/JSON-RPC Connect trực tiếp vào đó, ép server phun ra toàn bộ dữ liệu pool token của Gemini và Claude OSS qua local RPC, không qua dịch vụ quota trung gian.
Unit-of-Work Monolithic Controller
Xây dựng một bộ điều khiển trung tâm (Controller) duy nhất mang kiến trúc Monolithic cho việc cập nhật luồng dữ liệu UI (Refresh). Mọi tác nhân khởi tạo (từ timer chạy ngầm background, cú click nút bấm của user, cho tới luồng lưu config) đều hội tụ về một hàm cốt lõi duy nhất. Hệ thống cấp phát "generation token" để định tuyến luồng, nhờ đó tiêu diệt tận gốc hiện tượng xung đột tiến trình (overlapping) và đảm bảo vòng quay spinning báo trạng thái không bao giờ hiển thị ảo.
Triệt Hạ Bẫy mtime (mtime trap) Của Git
Git liên tục cập nhật ngầm file chỉ mục index trong thư mục .git/, làm cho mtime thay đổi và lừa rsync tưởng rằng có file mới cần đồng bộ, khiến nút PUSH liên tục nháy sáng gây ức chế. Bộ lọc khô (Dry-run Filter) của Aki Dev Sync sử dụng thuật toán quét chuỗi siêu tốc để cạo sạch các thay đổi chỉ-thư-mục (directory-only entries), ép hệ thống chỉ phát báo động khi có các tập tin mã nguồn thực sự (real code changes) được chỉnh sửa.
Baseline snapshot disambiguation
Sự thật là Rsync bị mù trạng thái (stateless): khi file X có ở máy A nhưng vắng ở máy B, Rsync không biết là máy A mới tạo file X, hay máy B mới xóa file X. Lỗ hổng này được xử lý bằng 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 phân biệt trạng thái theo snapshot.
Mới trong v1.28.0 (19/08/2026)
Bản 1.26.0 mở màn với phím tắt F1/F2/F3, preset Ultra 1400px và Donate modal. 1.27.0 thêm F12 ghim cửa sổ và đổi F2 thành nút chuyển đổi Ultra/Narrow. 1.28.0 thêm Glass Effect toggle, chuyển thư mục dữ liệu sang ~/.aki/devsync/ (tự di trú, đã xác minh trên máy thật), hạ GPU nhàn rỗi từ ~95% xuống ~25%, sửa F1–F3 hoạt động ngay cả khi đang gõ trong terminal tích hợp, và chặn biến môi trường phiên Claude Code cha rò vào các shell con.
Cài đặt
- Tải file .dmg mới nhất từ trang GitHub Releases (bản arm cho Apple Silicon, bản universal cho cả Intel và Apple Silicon).
- Mở file .dmg và kéo app vào thư mục Applications.
- Bản build chưa ký nên macOS Gatekeeper sẽ chặn lần mở đầu tiên, chuột phải vào app rồi chọn Open để xác nhận.
Yêu cầu: rsync và ssh có sẵn trên PATH (macOS đã cài sẵn cả hai), cộng một host SSH có thể kết nối tới được.
Công nghệ
Mã nguồn công khai trên GitHub. Repo chưa kèm file LICENSE nên đây là source-available, mở để xem và build, chưa gắn giấy phép mã nguồn công khai chính thức. App tải và dùng miễn phí.
Tác giả
Lạc Việt Anh , người sáng lập 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 remote.
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 AkiDevRule (baseline rule/skill cho Claude Code + Antigravity) và AkiDEV (tri thức kỹ thuật), đây là bộ công cụ phản ánh cách AkiTao làm việc với AI hằng ngày. Bài viết kỹ thuật đầy đủ về app này được đăng trên app.akinet.me, nền tảng mini-app của cùng hệ sinh thái.
Thuộc hệ sinh thái Aki, hơn 5.500 người dùng, một tài khoản dùng chung.
Câu hỏi thường gặp
Aki Dev Sync là gì?
Mô hình Local ↔ Remote hoạt động ra sao?
Cài đặt thế nào và yêu cầu cấu hình ra sao?
Aki Dev Sync đo quota AI chính xác bằng cách nào?
Statusline Customizer mang sức mạnh khủng khiếp gì?
Mã nguồn của Aki Dev Sync có công khai không?
Đồng bộ môi trường phát triển, code ở cả 2 phía chỉ trong một cú nhấn.
Tải Aki Dev Sync