agentcmd
Getting Started

Access Anywhere

Unlike desktop-only AI coding tools, agentcmd runs in your browser - making it the only AI workflow orchestrator you can access from your phone, tablet, or any device.

Why It Matters

Start workflows on your laptop. Monitor on your phone. Review on your tablet.

  • Long-running refactors? Check progress from your phone while getting coffee
  • Multi-hour test suites? Monitor from the couch
  • Client demo? Pull up live workflow execution on any device
  • Late-night deployment? Watch from bed without opening your laptop

Mobile-First Design

Built responsive from day one:

  • ✓ Real-time workflow timeline on mobile
  • ✓ Stream logs and outputs
  • ✓ Browse sessions and artifacts
  • ✓ Touch-optimized controls
  • ✓ Full feature parity with desktop

The entire UI adapts to your screen - no separate mobile app needed.

Remote Access with Tailscale

Access your local agentcmd server from anywhere with Tailscale's zero-config VPN:

Install Tailscale

On your development machine:

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

Download the Tailscale app for your phone/tablet (100% free for personal use).

Connect to your Tailnet

tailscale up

Follow the prompt to authenticate.

Expose with Tailscale Serve

Start agentcmd and expose it via Tailscale Serve:

# Start agentcmd
npx agentcmd start

# Expose via Tailscale (runs in background, persists across reboots)
tailscale serve --https=443 --bg localhost:4100

This creates an HTTPS proxy with automatic TLS certificates.

Check status:

tailscale serve status

Stop serving:

tailscale serve --https=443 off

Access from any device

On your phone/tablet (with Tailscale app connected):

https://your-machine-name.ts.net

Find your machine name with tailscale status or in the Tailscale admin console.

2-minute setup, lifetime access. Once configured, your agentcmd server is accessible on any device connected to your Tailnet - phone, tablet, or another laptop.

Alternative Remote Access Options

VPN

Connect to your home/office network via VPN and access:

http://localhost:4100

Works with any VPN: WireGuard, OpenVPN, corporate VPN, etc.

Cloud Deployment

Run agentcmd on a Mac Mini, home server, or always-on desktop for persistent access. Or deploy to a VPS for always-on remote access:

pm2 start "npx agentcmd start" --name agentcmd

See Deployment for production setup with HTTPS and authentication.

SSH Tunnel

Quick one-off access via SSH port forwarding:

ssh -L 4100:localhost:4100 your-dev-machine

Then access http://localhost:4100 on your local machine.

Security Considerations

When enabling remote access:

  • Tailscale encrypts all traffic automatically
  • VPN provides network-level security
  • Cloud deployments should use HTTPS and authentication
  • SSH tunnels are encrypted by default

For production use, consider adding authentication middleware to the agentcmd server.