Getting Started
Share your local AI agent with anyone through an encrypted relay — in under 5 minutes
Create Your Account
Sign up with your email or Google account. No credit card required.
Clone and Build the Agent
Clone the open-source agent and build it on your development machine.
Run these commands in your terminal:
git clone https://github.com/Commands-com/commands-com-agent.git
cd commands-com-agent && npm install && npm run build
Requires Node.js 20+ and a valid Claude API key or Claude Code auth. Works on macOS, Windows, and Linux.
Launch the Desktop App
The Desktop App walks you through setup and lets you start/stop your agent with one click.
Install desktop dependencies (first time only), then launch:
npm install --prefix ./desktop
npm run dev:desktop
The setup wizard guides you through agent profile, permissions, and MCP module configuration
Click Start Agent — your browser opens for OAuth sign-in automatically
The agent registers your device, generates identity keys, and connects to the relay
Live logs stream in the app — stop and restart anytime with one click
CLI Alternative
Prefer the terminal? Run ./start-agent.sh directly instead. See the README for all CLI options.
Start Remote Session
You're ready! Open the web chat and start coding from anywhere.
Next Steps
Common Questions
Do I need to open any ports on my firewall?
No! The local agent makes outbound connections only. No inbound ports or firewall changes required.
Where is my agent config stored?
Agent config and identity keys are stored at ~/.commands-agent/config.json with restricted file permissions (0600). They never leave your machine.
Can I use this from my phone?
Yes! The web interface works on any device with a modern browser, including phones and tablets.
What happens if my internet disconnects?
The agent automatically reconnects when your internet comes back. On Pro plans, you get priority reconnect queue access.
Still have questions? Contact our support team