Quick Start¶

Get your first Cloud Agent VM running in 5 minutes.

1. Deploy a Repository¶

From inside a git repository:

# Deploy the current repo (auto-detects git origin)
ca

Or specify a repository:

# Deploy a specific repo
SSH_KEY=~/.ssh/cloud-agent ca git@github.com:your-org/your-repo.git

First Run

The first deployment takes a few minutes as Terraform provisions the VM and installs dependencies.

2. SSH into Your VM¶

# Connect and auto-attach to tmux
ca ssh

You'll be dropped into a tmux session on your VM.

3. Start the AI Agent¶

# Navigate to your repo
cd /workspace/your-repo

# Start the agent
auggie  # or 'claude' for Claude Code

4. Detach and Go¶

Press Ctrl+B then D to detach from tmux. Your agent keeps running!

Later, reconnect with:

ca ssh

Common Workflows¶

Deploy Multiple Repos¶

ca git@github.com:org/repo1.git git@github.com:org/repo2.git

Use a Different Agent¶

ca --agent claude git@github.com:org/repo.git

Add a Repo to Existing VM¶

ca --skip-vm git@github.com:org/another-repo.git

Check VM Status¶

ca list

Stop Your VM (Save Costs)¶

ca stop

Resume Later¶

ca start
ca ssh

Clean Up¶

ca terminate

Example Session¶

$ ca git@github.com:myorg/myapp.git
🔍 Detecting public IP...
✅ Your IP: 203.0.113.42

🚀 Creating VM cloud-agent-jsmith...
✅ VM created successfully

📦 Cloning repositories...
✅ Cloned myapp

🔐 Transferring credentials...
✅ SSH key transferred
✅ Auggie credentials transferred

🎉 Ready! Connect with: ca ssh

$ ca ssh
# Now on the VM in tmux
$ cd /workspace/myapp
$ auggie "Fix all the TODO comments in this project"