Quickstart Guide
Get Arc0 up and running in 5 minutes. Install the CLI, download the app, and connect your coding agent.
By the end of this guide, you'll have your coding agent connected to your phone and ready to direct from anywhere.
Prerequisites
- A coding agent installed (Claude Code, Codex CLI, or Gemini CLI)
- macOS, Linux, or Windows on your development machine
- An iOS or Android device (or use the webapp)
Install Arc0 CLI
Arc0 CLI runs on your development machine and captures your agent sessions via tmux.
bash brew tap arc0ai/tap brew install arc0
bash npm install -g @arc0/cli Download the latest release from GitHub Releases and add it to your PATH.
Verify the installation:
arc0 --versionDownload the Mobile App
Get the Arc0 app on your phone:
- iOS: Download on the App Store (or TestFlight for beta)
- Android: Download on Google Play (or APK from GitHub)
- Webapp: Use the web interface at app.arc0.ai
During the beta period, apps are available through TestFlight (iOS) and direct APK download (Android).
Pair Your Devices
Start Arc0 CLI and pair with your phone:
arc0 pairThis displays a QR code in your terminal. Open the Arc0 app and scan the code to connect.
The pairing establishes a secure WebSocket connection through a tunnel. You only need to do this once—the connection persists across sessions.
Run Your Agent
Start your coding agent in a tmux session. Arc0 CLI automatically detects and captures it.
# Start tmux and run Claude Code
tmux new -s dev
claudeArc0 CLI attaches automatically—no wrapper needed.
tmux new -s dev
codextmux new -s dev
geminiArc0 CLI streams the session to your phone over WebSocket in real-time.
Direct from Your Phone
When your agent needs input or proposes a plan, you'll get a push notification. Open the app to:
- Approve plans before the agent starts coding
- Send prompts to guide the agent's work
- Monitor progress in real-time
- Review diffs and approve or reject changes
- Track modifications across your codebase
Your response is sent back to the agent instantly over WebSocket.
You're all set! Your coding agent is now connected to your phone.
Configuration Options
Arc0 CLI supports several configuration options:
| Option | Description | Default |
|---|---|---|
--port | Port for the local server | 3847 |
--no-notifications | Disable push notifications | false |
--log-level | Logging verbosity (debug, info, warn, error) | info |
Example with options:
arc0 start --port 4000 --log-level debugSee CLI Configuration for the full reference.
Troubleshooting
Can't scan the QR code? Make sure your phone and computer are on the same network, or try the manual pairing option in the app.
Not receiving notifications? Check that notifications are enabled for Arc0 in your phone's settings.
Agent not detected? Make sure your agent is running inside a tmux session.
See Troubleshooting for more solutions.
Next Steps
How Arc0 Works
Understand the architecture behind Arc0—how the CLI, tunnel, and mobile app work together to connect you with your coding agents.
Security & Privacy
Learn how Arc0 protects your code and data with end-to-end encryption, local-only architecture, and secure WebSocket tunnels. Your codebase never leaves your machine.