SSH & File Transfer¶
Connect to your VM and transfer files.
SSH into VM¶
This:
- Connects via SSH to your Cloud Agent VM
- Automatically attaches to (or creates) a tmux session
- Drops you into the
/workspacedirectory
Tmux Basics¶
Cloud Agent uses tmux so your work persists if you disconnect.
| Action | Keys |
|---|---|
| Detach (leave running) | Ctrl+B then D |
| New window | Ctrl+B then C |
| Next window | Ctrl+B then N |
| Previous window | Ctrl+B then P |
| Split horizontal | Ctrl+B then " |
| Split vertical | Ctrl+B then % |
| Switch pane | Ctrl+B then arrow key |
Direct SSH¶
You can also SSH directly:
File Transfer¶
Copy files between your local machine and the VM.
Copy to VM¶
# Single file
ca scp ./local-file.txt vm:/workspace/
# Directory
ca scp -r ./local-dir vm:/workspace/
# To specific path
ca scp ./config.json vm:/home/user/.config/
Copy from VM¶
# Single file
ca scp vm:/workspace/output.txt ./
# Directory
ca scp -r vm:/workspace/results ./local-results
# Specific file
ca scp vm:/home/user/.bashrc ./bashrc-backup
Direct SCP¶
Using standard scp:
# Get VM IP
ca list
# Copy to VM
scp -i ~/.ssh/cloud-agent ./file.txt user@35.192.0.42:/workspace/
# Copy from VM
scp -i ~/.ssh/cloud-agent user@35.192.0.42:/workspace/file.txt ./
Workspace Layout¶
On the VM, repositories are cloned to /workspace/:
Credentials on VM¶
Your credentials are stored in the standard locations:
| Credential | VM Path |
|---|---|
| SSH key | ~/.ssh/id_ed25519 |
| Auggie | ~/.augment/ |
| Claude | ~/.claude/ |
| Git config | ~/.gitconfig |
Troubleshooting¶
Connection Refused¶
- Check VM is running:
ca list - Start if stopped:
ca start - Wait for startup (1-2 minutes)
Permission Denied¶
- Check SSH key path:
ls ~/.ssh/ - Verify key is added to GitHub
- Re-deploy with correct key:
SSH_KEY=~/.ssh/mykey ca