Arc0 CLI
Install and configure Arc0 CLI on macOS, Linux, or Windows. Connect Claude Code, Codex, and Gemini CLI to your phone via a secure WebSocket tunnel.
The CLI captures agent sessions via tmux and streams them over a secure WebSocket tunnel. Your full codebase never leaves your machine.
What It Does
- Attaches to tmux — Watches your terminal sessions where agents run
- Parses content — Identifies questions, diffs, plans, and status updates
- Streams via WebSocket — Sends content to your phone through a secure WSS tunnel
- Relays responses — Forwards your prompts and approvals back to the agent
Your full codebase never leaves your machine.
Installation
Homebrew (Recommended)
brew tap arc0ai/tap
brew install arc0npm
npm install -g @arc0/cliBinary Download
curl -L https://github.com/amicalhq/arc0/releases/latest/download/arc0-darwin-arm64.tar.gz | tar xz
sudo mv arc0 /usr/local/bin/For Intel Macs, use arc0-darwin-x64.tar.gz.
npm (Recommended)
npm install -g @arc0/cliBinary Download
curl -L https://github.com/amicalhq/arc0/releases/latest/download/arc0-linux-x64.tar.gz | tar xz
sudo mv arc0 /usr/local/bin/
sudo chmod +x /usr/local/bin/arc0For ARM64 systems, use arc0-linux-arm64.tar.gz.
npm (Recommended)
npm install -g @arc0/cliBinary Download
- Download
arc0-windows-x64.zipfrom GitHub Releases - Extract to a folder (e.g.,
C:\Program Files\Arc0) - Add the folder to your PATH
WSL
Follow the Linux instructions inside your WSL environment.
Verify installation:
arc0 --versionGetting Started
Run Your Agent
Start your coding agent in a tmux session:
tmux new -s dev
claudeArc0 CLI automatically captures the session and streams it to your phone.
Configuration
Arc0 CLI looks for config at ~/.arc0/config.yaml.
Example Configuration
# Server settings
port: 3847
host: "127.0.0.1"
# Logging
log_level: "info" # debug, info, warn, error
# Notifications
notifications:
enabled: true
on_question: true
on_error: true
on_diff: true
on_plan: true
on_complete: false
# Agent detection
agents:
- name: "claude"
pattern: "claude"
- name: "codex"
pattern: "codex"
- name: "gemini"
pattern: "gemini"Command-Line Flags
| Flag | Description | Default |
|---|---|---|
--port | Port for the local server | 3847 |
--log-level | Logging verbosity | info |
--no-notifications | Disable notifications | false |
--config | Path to config file | ~/.arc0/config.yaml |
Environment Variables
| Variable | Description |
|---|---|
ARC0_PORT | Server port |
ARC0_LOG_LEVEL | Logging level |
ARC0_CONFIG | Config file path |
Custom Agents
Add detection patterns for agents Arc0 doesn't recognize:
agents:
- name: "my-agent"
pattern: "my-custom-agent"
question_patterns:
- "\\?$"
- "^Should I"
- "^Do you want"Supported Platforms
| Platform | Support |
|---|---|
| macOS (Intel) | Full |
| macOS (Apple Silicon) | Full |
| Linux (x64) | Full |
| Linux (ARM64) | Full |
| Windows (x64) | Full |
| WSL | Full |
Requirements
- Node.js 18+ (for npm installation) or standalone binary
- tmux installed on your system
Updating
bash brew upgrade arc0 bash npm update -g @arc0/cli Troubleshooting
Command not found? Make sure the installation directory is in your PATH.
Permission denied? Use sudo for global npm installs, or use nvm.
See Troubleshooting for more help.
Next Steps
Introduction to Arc0
Arc0 is a mobile command center for coding agents. Direct Claude Code, Codex, and Gemini CLI from your phone—approve plans, monitor progress, and review changes.
Frequently Asked Questions
Answers to common questions about Arc0 setup, compatibility, security, mobile app features, self-hosting, and coding agent integrations.