Aki Dev Sync
A central control station for split development environments. Keep code local, push heavy tasks remote via SSH, and sync bidirectionally using baseline snapshot disambiguation without polluting git. Features native RPC & cache hook AI quota monitoring and a full suite of project tools.
Push-only & Mirror Delete
Push local source code to a remote server for AI agents to grind on, then reap the fully generated code back. Provides a powerful DRY RUN dashboard predicting every byte change. The killer feature is turning .git/ into a push-only path: pushing history up fuels the AI's context, but blocking it from pulling down permanently banishes the mtime trap causing phantom Sync alerts. The mirror-delete mode safely prevents accidental overwrites when PUSHing.
Bidirectional Baseline Snapshot Engine
Rsync is stateless (blind): when file X exists on A but is absent on B, it doesn't know who deleted X. This fatal flaw is permanently patched via the baseline snapshot disambiguation architecture. After every successful sync, the app writes a baseline snapshot to a local JSON file. It cross-references this snapshot to instantly distinguish whether file X was deleted locally (accepted) or newly created remotely (ignored), using the snapshot to compare state.
Claude Code Quota
Completely obliterates vague token estimation technologies. The system deploys a Hybrid Patching core piercing through SSH to read hidden rate_limits (5h and 7d windows) directly from the Anthropic CLI's cache. Bash+jq injection handles HTTP 429 quirks, sustaining data rendering even during total lockouts (quota exhaustion) without crashing the UI.
Antigravity Local RPC
Reads Antigravity usage from its local Connect RPC endpoint after detecting the IDE process and port; it does not depend on an intermediary quota service.
Git & Smart Launcher
The Git Panel integrates a custom Regex ANSI Parser decoding native terminal color codes alongside Mermaid-powered visual changelog previews. The Smart Open launcher analyzes package configuration files (package.json, Nuxt, Tauri) to auto-generate 1-click DEV and BUILD buttons, opening an in-app terminal tab with high sophistication.
Meticulous UX
The Monolithic Unit-of-Work Controller fuses all state check triggers to eradicate overlapping bugs. Task lists employ a CSS Zero-JS Textarea architecture that flawlessly auto-expands without ResizeObserver lag. The Statusline Customizer builds bash configs with a 5-tier color ladder via pure HTML5 drag-and-drop operations, now deploying to both Claude Code and the Antigravity CLI (AGY) from a single unified config, with both CLIs sharing one identical script instead of two that could drift apart.
How It Works & Built-In Toolkit
Local as source of truth, Remote as the AI workspace
The local control of your git history remains strictly on your local machine, where you conduct rigorous reviews and commit. Conversely, the SSH remote machine acts as the "industrial workshop", where AI agents (Claude Code, Claude MAX) directly ingest the massive project context and generate substantial code changes. The PUSH button thrusts all modifications (including .git/ so the AI absorbs codebase history) up to the remote. The PULL button sweeps up everything the AI tirelessly produced, bringing it back locally for your audit prior to commit, finalizing a flawless closed-loop lifecycle.
Engineering Prowess & Project management
- Unit-of-Work Controller: A supreme monolithic background architecture that funnels all data stream refresh requests (whether from background cycles, manual clicks, or config saves) into a singular function, using generation tokens to annihilate process overlapping, guaranteeing accurate loading states.
- Zero-JS Textarea: Project notes and Global Notes use
field-sizing: contentto grow with their content without custom JavaScript resize logic. - Smart Open Popup: Not just simple shortcuts, but a true analyzer engine that recursively scans lockfiles (Nuxt/Node/Tauri) to interpolate and dynamically generate 1-click DEV/BUILD commands, firing them straight into your local Terminal or through SSH tunnels.
- Regex ANSI Git panel: Discarding bland outputs, a heavy-duty client-side Regex parser intercepts raw terminal color codes (decoding escape sequences) to render Git logs in pristine original colors, while supporting Unicode via forced
core.quotepath=falseconfiguration. - SSH Config Editor & Hooks: An SSH config editor embedded with a safety net mechanism that auto-generates backups before saving. Accompanied by a shell scripting architecture that clamps Pre/Post Hooks around both ends of the rsync lifecycle, unlocking potential for auto-triggering Docker containers.
Pin workspace: one macOS Desktop per project
Hard-pin the Tauri window piercing through all macOS Desktops/Spaces (workspaces). By equipping work-area-aware size restructuring presets (like ultra-slim Narrow, corner-locked Stick Top-Left, or Center Primary), the app transforms into an immovable command center. This allows you to swipe rapidly back and forth across dozens of large and small projects while perpetually controlling the sync status and AI quota of every single project in the exact same familiar screen spot. These layout presets can now be bound to F1/F2/F3 shortcuts and persist across launches, restoring your chosen position and size automatically instead of making you pick a preset again every time the app starts. Read the full spatial macOS workflow.
No intermediary server
Your entire dataset is inviolable. Aki Dev Sync executes secure data synchronization exclusively through native rsync and ssh encrypted tunnels connecting directly to SSH server clusters over which you hold direct control. There is zero code secretly beaming your source files or quota metrics through any intermediary proxy servers owned by the author or third-party services.
Frequently Asked Questions
What problem does Aki Dev Sync solve?
It keeps code in sync between a local machine (where you review/commit) and a remote machine (where you run builds or AI agents), without creating junk commits just to move files between the two.
Is Aki Dev Sync free and source-available?
The source code is public at github.com/lacvietanh/aki-dev-sync. Since the license terms can change over time, check the current license directly on the GitHub page before relying on it for commercial use.
What platforms does Aki Dev Sync support?
macOS only, with a Universal build that runs on both Apple Silicon and Intel chips. There is no Windows or Linux version.
Does the remote machine need to run Claude Code specifically?
Not for the file-sync part; PUSH/PULL work independently of whatever AI agent is running. The quota-monitoring feature currently has deep support for Claude Code and Antigravity specifically; other agents can still use the remote machine over SSH but will not get a dedicated quota panel.
Is my code sent through a third-party server?
No. Aki Dev Sync syncs directly via rsync and ssh to an SSH host you configure yourself, with no intermediary server owned by the author or any third party.
Do I need to install extra software to run it?
Just rsync and ssh, both already available on macOS, plus an SSH host your machine can reach.
What is a Claude Code statusline?
It is the status line shown at the bottom of a Claude Code CLI session, typically showing the current directory, active model, remaining context window percentage, and other operational details, generated by a bash script the user configures.
Do I need the full Aki Dev Sync app to use just the statusline script?
No. The statusline script ships standalone at share/aki-statusLine/statusline.sh in the repo. Copy it to ~/.claude/statusline-command.sh and reference it in ~/.claude/settings.json, no app install required.
What does the 5-tier color ladder mean?
It is 5 color tiers by urgency of a percentage value: blue below 25%, green 25-55%, yellow 55-75%, orange 75-88%, red at 88% and above, with bands narrowing as urgency increases.
Can I push the statusline config to a remote server too?
Yes. The Statusline Customizer supports applying a configuration to the local machine and/or any number of configured SSH remote hosts at once, so one edit updates it everywhere.
What is a macOS Space or Desktop?
A separate virtual workspace on the same physical screen, each Space can hold a different set of app windows, switched between with a three/four-finger swipe (Ctrl+swipe) or Control plus left/right arrow, letting you separate work contexts without needing multiple physical monitors.
Does pinning the window across Spaces affect performance?
Pinning uses macOS window options for always-on-top and visibility across workspaces; actual resource use still depends on the app state and work it is doing.
Does this require any setup beyond the window-size presets?
No. Just toggle the pin (thumbtack) button on the titlebar and pick one of the window-size presets from the app-icon menu (☰); no extra macOS configuration or project setup is needed.
Related articles
What Is Aki Dev Sync? A macOS App to Sync Split Dev Environments
Aki Dev Sync is a macOS tool by Lac Viet Anh that keeps a split development environment in sync, allowing you to code on both sides without polluting git.
Statusline Customizer in Aki Dev Sync: Build a Claude Code Status Line
Toggle fields, drag to reorder, pick colors from swatches: the Statusline Customizer turns editing a Claude Code statusline into drag-and-drop.
Multiple Projects Across macOS Desktops With Aki Dev Sync
A real workflow tip: pin Aki Dev Sync in a fixed screen corner across every Desktop, so you never lose track of which project needs a push or pull.