Architecture
Understanding how Sincronizado works.
Overview
Sincronizado creates a seamless bridge between your local development environment and a remote VPS running AI agents.
Benefits:
- Zero collision even with duplicate project names
- Deterministic based on full path
- 6-character hash for readability
5. Mobile Access (Agent-OS)
- Web UI: Access from any browser
- Real-time: See agent output live
- Control: Start/stop sessions remotely
- Responsive: Works on phone screens
Optional Components (Full Mode)
6. Discord Integration (Kimaki)
- Purpose: Control agents via Discord
- Features: Text commands, voice transcription, file attachments
- Architecture: One bot per VPS, channels map to projects, threads map to sessions
- Security: Role-based access ("Kimaki" role required)
7. AI Debugging (LunaRoute)
- Purpose: Proxy and monitor AI API calls
- Features: Token tracking, session recording, cost analysis
- Web UI: Debug dashboard at port 8082
- Performance: <0.5ms overhead
8. Git Worktree Sessions
- Purpose: Isolated development per task
- Features: Auto-creates worktree per session, auto-commits on exit
- Safety: Refuses to run on main branch
- Cleanup: Removes worktree after session ends
Data Flow
- Local Edit → Mutagen detects change
- Sync → File pushed to VPS in <500ms
- Agent Notices → AI sees updated code
- Remote Execution → Heavy work runs on VPS
- Results Sync → Output files return locally
Security
- VPN: All traffic encrypted via Tailscale
- No Open Ports: Only accessible within VPN
- Session Isolation: Each project in separate tmux session
- No Secrets in Repo: Config stored locally only
Performance
| Metric | Target | Achieved |
|---|---|---|
| File Sync | <500ms | ✓ |
| Session Connect | <2s | ✓ |
| Network Handoff | Seamless | ✓ |
| Mobile Access | <1s | ✓ |
Troubleshooting
See the Troubleshooting Guide for common issues.