cc-aha-cli
v1.19.6
Published
Mobile and Web client for Claude Code and Codex
Readme
Aha
Code on the go controlling claude code from your mobile device.
Free. Open source. Code anywhere.
🚀 Quick Start
1. Install
npm install -g cc-aha-cliNote: The package name is
cc-aha-cli, but the command you use is stillaha. Nothing changes for end users!
2. Start the Daemon
aha daemon start3. Open Web App
Visit https://top1vibe.com/webapp in your browser or mobile device to:
- Control Claude Code remotely from any device
- Create multi-agent teams (Master, Builder, QA, etc.)
- No local configuration needed - enjoy full team collaboration out of the box!
✨ Features
- 🌍 Code Anywhere: Control Claude Code from mobile, tablet, or any browser
- 🤝 Multi-Agent Teams: Built-in support for 22 specialized roles (Master, Builder, Architect, QA, etc.)
- 🔒 End-to-End Encryption: All communications are encrypted with TweetNaCl
- 🔄 Real-time Sync: Instant session sharing across all your devices
- 📱 Mobile First: Optimized for mobile coding experience
- 🆓 Free & Open Source: MIT licensed
Basic Usage
ahaThis will:
- Start a Claude Code session
- Display a QR code to connect from your mobile device
- Allow real-time session sharing between Claude Code and your mobile app
Commands
aha auth– Manage authenticationaha codex– Start Codex modeaha connect– Store AI vendor API keys in Aha cloudaha notify– Send a push notification to your devicesaha daemon– Manage background serviceaha doctor– System diagnostics & troubleshooting
Daemon
The daemon is a background service that enables remote control from the mobile app and handles team session spawning.
Starting the Daemon
# Start daemon with default server
./bin/aha.mjs daemon start
# Start daemon with custom server URL (for local development)
AHA_SERVER_URL=http://localhost:3005 ./bin/aha.mjs daemon start
# Check daemon status
./bin/aha.mjs daemon status
# Stop daemon
./bin/aha.mjs daemon stopDaemon for Teams
Important: The daemon must be running to create teams with auto-spawned agent sessions. When you create a team in the mobile app with spawned agents (e.g., Master, Builder, Framer), the daemon:
- Receives the spawn request from the mobile app
- Creates new Claude sessions with
teamIdandrolein their metadata - Sets environment variables (
AHA_ROOM_ID,AHA_AGENT_ROLE) for team context - Manages the lifecycle of spawned sessions
Daemon Logs
Daemon logs are stored in ~/.aha/logs/ (or $AHA_HOME_DIR/logs/):
- Format:
YYYY-MM-DD-HH-MM-SS-pid-PID-daemon.log - Session logs:
YYYY-MM-DD-HH-MM-SS-pid-PID.log
View logs for debugging:
# View daemon logs
tail -f ~/.aha/logs/*-daemon.log
# View specific session logs
tail -f ~/.aha/logs/2026-01-17-12-49-59-pid-20555.logOptions
-h, --help- Show help-v, --version- Show version-m, --model <model>- Claude model to use (default: sonnet)-p, --permission-mode <mode>- Permission mode: auto, default, or plan--claude-env KEY=VALUE- Set environment variable for Claude Code--claude-arg ARG- Pass additional argument to Claude CLI
Environment Variables
AHA_SERVER_URL- Custom server URL (default: https://top1vibe.com)AHA_WEBAPP_URL- Custom web app URL (default: https://app.aha.engineering)AHA_HOME_DIR- Custom home directory for Aha data (default: ~/.aha)AHA_DISABLE_CAFFEINATE- Disable macOS sleep prevention (set totrue,1, oryes)AHA_EXPERIMENTAL- Enable experimental features (set totrue,1, oryes)
Requirements
- Node.js >= 20.0.0
- Required by
[email protected], which is required by@modelcontextprotocol/sdk, which we used to implement permission forwarding to mobile app
- Required by
- Claude CLI installed & logged in (
claudecommand available in PATH)
📚 Documentation
- Getting Started Guide - Comprehensive guide with use cases and examples
- Contributing Guide - How to contribute to Aha development
- Promotion Materials - Help spread the word about Aha
📞 Contact & Support
Need help or want to contribute? Reach out to us:
- Email: [email protected]
- WeChat: CopizzaH (add with note "Aha User")
- Issues: GitHub Issues
- Discussions: GitHub Discussions
We're here to help you get the most out of Aha!
License
MIT
