Perry Workspaces

Isolated Docker workspaces on your tailnet with coding agents pre-installed.

Commands

perry start <name> --clone git@github.com:user/repo.git  # Create
perry ls                                                  # List
perry stop <name>                                         # Stop
perry remove <name>                                       # Delete
perry shell <name>                                        # Interactive shell

SSH Access

ssh workspace@<name>        # User is always 'workspace'
ssh workspace@<IP>          # Use IP if MagicDNS fails

Coding Agents

• OpenCode: http://<workspace>:4096 (web UI) or attach via CLI
• Claude Code: Run inside workspace shell (perry shell then claude)

Project Location

Projects clone to ~/<name>, not /workspace:

cd ~/my-project  # Correct

Troubleshooting

• Can't reach: Check tailscale status, use IP instead of hostname
• SSH fails: User must be workspace, not your local user
• Slow start: Check web UI for progress