aha-agi

Aha CLI

Control Claude Code from your mobile device. Run multi-agent teams. Code anywhere.

Published npm builds are proprietary and unlicensed. No source license is granted.

Architecture

Mobile / Browser          Aha Server              Local Machine
─────────────────         ──────────────          ──────────────────────
 Web App (UI)   ◄────►   WebSocket / E2E  ◄────►  aha daemon
 iOS / Android           Encrypted relay           └─ Claude Code sessions
                                                   └─ Multi-agent teams

All traffic is end-to-end encrypted with TweetNaCl before leaving your device. The Aha server relays encrypted bytes only — it never sees your code or prompts.

Quick Start

1. Install

npm install -g aha-agi

2. Start the Daemon

aha daemon start

3. Open Web App

Visit https://aha-agi.com/webappv3 in your browser or mobile device.

Features

• Code Anywhere: Control Claude Code from mobile, tablet, or any browser
• Multi-Agent Teams: Built-in support for specialized roles (Master, Builder, Architect, QA, etc.)
• End-to-End Encryption: All communications encrypted with TweetNaCl
• Real-time Sync: Instant session sharing across all your devices
• Proprietary npm package: no open-source license is granted

Commands

Command	Description
aha	Start a Claude Code session with QR code
aha daemon start	Start the background daemon
aha daemon stop	Stop the daemon
aha daemon status	Check daemon status
aha auth	Manage authentication
aha auth reconnect	Refresh cached account
aha auth login --code <key>	Restore account from backup key
aha auth join --ticket <ticket>	Join existing account
aha codex	Start Codex mode
aha connect	Store AI vendor API keys in Aha cloud
aha notify	Send push notification to devices
aha doctor	System diagnostics & troubleshooting

Options

Flag	Description
-h, --help	Show help
-v, --version	Show version
-m, --model <model>	Claude model (default: sonnet)
-p, --permission-mode <mode>	Permission mode: auto, default, or plan
--claude-env KEY=VALUE	Set env variable for Claude Code
--claude-arg ARG	Pass additional argument to Claude CLI

Environment Variables

Variable	Default	Description
AHA_HOME_DIR	~/.aha	Data directory
AHA_SERVER_URL	https://aha-agi.com/api	Server URL
AHA_WEBAPP_URL	https://aha-agi.com/webappv3	Web app URL
AHA_CONFIG_FILE	~/.aha/config.json	Config file path
AHA_DISABLE_CAFFEINATE	—	Set to true to disable macOS sleep prevention
AHA_EXPERIMENTAL	—	Set to true to enable experimental features

Persistent config can also live in ~/.aha/config.json:

{
  "serverUrl": "http://localhost:3005",
  "webappUrl": "http://localhost:8081"
}

Daemon Logs

Logs are stored in ~/.aha/logs/ (or $AHA_HOME_DIR/logs/):

# View daemon logs
tail -f ~/.aha/logs/*-daemon.log

# View session logs
tail -f ~/.aha/logs/2026-01-17-12-49-59-pid-20555.log

Third-Party Notices

Aha CLI depends on @anthropic-ai/claude-code, which is proprietary software owned by Anthropic and distributed under its own license terms. By using Aha CLI, you agree to comply with Anthropic's usage policies and the terms governing the Claude Code SDK.

Third-party packages retain their own license terms.

License

UNLICENSED. The npm package is proprietary. No permission is granted to copy, modify, distribute, sublicense, or sell this package except as explicitly authorized by the owner.

Contact

Use your existing Aha support channel.