perry-workspaces

// Create and manage isolated Docker workspaces on your tailnet with Claude Code and OpenCode pre-installed. Use when working with Perry workspaces, connecting to coding agents, or managing remote development environments.

$ git log --oneline --stat

stars:370

forks:70

updated:February 19, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

nameperry-workspaces

descriptionCreate and manage isolated Docker workspaces on your tailnet with Claude Code and OpenCode pre-installed. Use when working with Perry workspaces, connecting to coding agents, or managing remote development environments.

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