Perry Workspaces
Isolated Docker workspaces on your tailnet with coding agents pre-installed.
Commands
bash
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
bash
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 shellthenclaude)
Project Location
Projects clone to ~/<name>, not /workspace:
bash
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