AgentHub

Code on the go — control AI coding agents from your phone, browser, or terminal.

Free. Open source. Code anywhere.

Installation

npm install -g @artsum/agenthub

The npm package is @artsum/agenthub; the installed command is still agenthub.

Usage

Claude Code (default)

agenthub
# or
agenthub claude

This will:

1. Start a Claude Code session
2. Display a QR code to connect from your mobile device or browser
3. Allow real-time session control — all communication is end-to-end encrypted
4. Start new sessions directly from your phone or web while your computer is online

More agents

agenthub codex
agenthub gemini
agenthub openclaw

# or any ACP-compatible CLI
agenthub acp opencode
agenthub acp -- custom-agent --flag

Daemon

The daemon is a background service that stays running on your machine. It lets you spawn and manage coding sessions remotely — from your phone or the web app — without needing an open terminal.

agenthub daemon start
agenthub daemon stop
agenthub daemon status
agenthub daemon list
agenthub daemon install
agenthub daemon uninstall
agenthub doctor
agenthub doctor clean

The daemon starts automatically when you run agenthub, so you usually don't need to manage it manually. On Linux machines that should stay online, prefer agenthub daemon install so the user-level agenthub-daemon.service manages startup and restart. The generated systemd service uses KillMode=process; keep that setting so daemon restarts do not kill active agent sessions and leave the app stuck in a thinking state.

Authentication

agenthub auth login
agenthub auth logout

AgentHub uses cryptographic key pairs for authentication — your private key stays on your machine. All session data is end-to-end encrypted before leaving your device.

To connect third-party agent APIs:

agenthub connect gemini
agenthub connect claude
agenthub connect codex
agenthub connect status

Commands

| Command | Description | |---------|-------------| | agenthub | Start Claude Code session (default) | | agenthub codex | Start Codex mode | | agenthub gemini | Start Gemini CLI session | | agenthub openclaw | Start OpenClaw session | | agenthub acp | Start any ACP-compatible agent | | agenthub resume <id> | Resume a previous session | | agenthub notify | Send push notification to your devices | | agenthub doctor | Diagnostics & troubleshooting | | agenthub doctor clean | Clean up stale AgentHub daemon/session processes |

Advanced

Environment Variables

| Variable | Description | |----------|-------------| | AGENTHUB_SERVER_URL | Custom server URL (default: https://agenthub.yzsd.asia:8443) | | AGENTHUB_WEBAPP_URL | Custom web app URL (default: http://localhost:13017) | | AGENTHUB_HOME_DIR | Custom home directory for AgentHub data (default: ~/.agenthub) | | AGENTHUB_DISABLE_CAFFEINATE | Disable macOS sleep prevention | | AGENTHUB_EXPERIMENTAL | Enable experimental features |

Sandbox (experimental)

AgentHub can run agents inside an OS-level sandbox to restrict file system and network access.

agenthub sandbox configure
agenthub sandbox status
agenthub sandbox disable

Building from source

pnpm install
pnpm --filter @artsum/agenthub build
pnpm --filter @artsum/agenthub cli -- --help

Requirements

• Node.js >= 20.0.0
• For Claude: claude CLI installed & logged in
• For Codex: codex CLI installed & logged in
• For Gemini: npm install -g @google/gemini-cli + agenthub connect gemini

License

MIT