Itwillsync
Sync any terminal-based AI coding agent to your phone. Claude Code, Aider, Codex. Local network, zero cloud.
Last verified:
What is Itwillsync?
Itwillsync is an open-source tool that syncs any terminal-based AI coding agent to your phone over a local network. It allows developers to control coding agents like Claude Code, Aider, Codex, Goose, and Cline directly from their mobile browser by scanning a QR code, with no app installation required. The tool provides full terminal access via a browser-based terminal built with xterm.js, enabling users to type commands, approve prompts, and fix errors from anywhere.
Key features include a multi-session dashboard that shows all running agents at a glance with status, working directory, and uptime; real-time WebSocket connections for live terminal updates; attention detection that alerts you when an agent needs input (auto-detects BEL/OSC signals); mobile-optimized controls with a touch-friendly extra keys bar featuring Ctrl, Alt, Tab, Escape, arrows, and function keys; and multiple connection modes including local WiFi, Tailscale for remote access anywhere, and Cloudflare Tunnel options.
Itwillsync is designed for developers using AI coding tools who want to stay connected to their coding environment while away from their desk—whether in the kitchen, on the couch, at a coffee shop, or in a meeting. The tool is agent-agnostic (works with any terminal-based tool), privacy-first with end-to-end encryption and zero cloud involvement, and has zero friction to get started with just one npx command requiring no install or configuration.
Itwillsync pricing
Pricing model: Freemium
Completely free and open-source under MIT license. No subscription fees, no paid tiers, no premium features. The tool operates solely on your local area network with no cloud involvement, and there are no subscription fees mentioned. As an open-source project, you can explore the source code directly on GitHub.
Itwillsync pros
- Open-source with MIT license
- No app installation needed—browser-based terminal
- Works with any terminal-based AI agent (Claude Code, Aider, Codex, Goose, Cline)
- Local network only—zero cloud involvement for privacy
- End-to-end encrypted WebSocket connections with NaCl secretbox
- 64-character cryptographically random per-session tokens
- Multi-session dashboard showing all running agents
- Real-time status, working directory, and uptime display
- Auto-detects BEL/OSC signals for agent attention notifications
- Touch-friendly extra keys bar (Ctrl, Alt, Tab, Escape, arrows, function keys)
- Tailscale support for remote access from anywhere
- Cloudflare Tunnel option for remote access without VPN
- Auto-reconnect with scrollback buffer sync if connection drops
- Audio and visual notifications when agents need attention
- Works on macOS, Windows, and Linux
- No accounts, no signup, no telemetry
- Rate limiting protects against brute force (5 failed attempts locks IP for 60 seconds)
- Sleep prevention keeps machine awake during long tasks
- Simultaneous control from phone and laptop
- QR code authentication—no manual token entry needed
Itwillsync cons
- Requires Node.js 20+ installed
- Phone must be on same local WiFi network by default
- Tailscale setup required on both laptop and mobile for remote access
- No native mobile app—browser-based only
- Limited to terminal-based agents only
- First-time setup requires running setup wizard
- No cloud backup of sessions
- Requires manual/command-line invocation to start sessions
- 64-character token must be kept safe (no recovery if lost)
- May have latency issues on slower local networks
Frequently asked questions about Itwillsync
What is itwillsync?
Itwillsync is an open-source tool that syncs any terminal-based AI coding agent to your phone over a local network. It lets you control coding agents like Claude Code, Aider, and Codex from your mobile browser by scanning a QR code, with no app installation needed.
How do I get started with itwillsync?
Run one command: npx itwillsync claude (for Claude Code), npx itwillsync aider (for Aider), or npx itwillsync bash (for any terminal command). No install is needed beforehand—just Node.js 20+. After running the command, a QR code appears in your terminal that you scan with your phone to open the browser-based terminal.
What AI coding agents work with itwillsync?
Itwillsync works with Claude Code, Aider, Codex, Goose, Cline, Copilot CLI, and any other tool that runs in a terminal. If it runs in a terminal, itwillsync can sync it. The tool is agent-agnostic and not locked to any single vendor or platform.
Is itwillsync free to use?
Yes, itwillsync is completely free and open-source under the MIT license. There are no subscription fees, no paid tiers, and no premium features. The project operates with no cloud involvement and no accounts required.
How secure is itwillsync?
Itwillsync is privacy-first with end-to-end encryption using NaCl secretbox (XSalsa20-Poly1305). Each session generates a cryptographically random 64-character token embedded in the QR code. All WebSocket connections require token authentication with constant-time comparison. Rate limiting locks out IPs for 60 seconds after 5 failed auth attempts. No data leaves your local network or Tailscale tailnet, and there is no telemetry or tracking.
What is the multi-session dashboard?
The multi-session dashboard is a hub daemon that manages all your running agent sessions from one place. It shows session cards with agent name, working directory, status (Active/Attention/Idle), and uptime. Real-time updates happen via WebSocket, and you can tap any card to open the full terminal. The dashboard also provides attention detection alerts when an agent needs input.
Does itwillsync work on mobile browsers?
Yes, the phone terminal is built for mobile with a touch-friendly extra keys bar featuring Ctrl, Alt, Tab, Escape, arrows, and function keys. It uses WebGL-accelerated rendering on desktop with canvas fallback on mobile, includes auto-reconnect with scrollback buffer sync if the connection drops, and provides audio notifications when agents need attention.
Can I control my agent from both phone and laptop simultaneously?
Yes, you can control your agent from your phone, laptop, or both simultaneously. The terminal session is mirrored across devices, so commands typed on either device appear on both. This is useful for monitoring while away from your desk while still having access from your laptop when you return.
How do I set up itwillsync for development or contribution?
Clone the repository with git clone https://github.com/shrijayan/itwillsync.git, cd into itwillsync, use Node 22 via nvm use, run pnpm install, then pnpm build to build all packages, and pnpm test to run tests. The monorepo structure includes packages/cli (main npm package), packages/web-client (browser terminal with xterm.js), packages/hub (dashboard daemon), packages/landing (landing page), and packages/docs (VitePress documentation). See CONTRIBUTING.md for development setup and PR guidelines.