Profile My skills Saved My plugins Edit profile Submit a skill

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.

modbender Updated 12 repo stars
DevOps & Infra

File contents

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

modbender/skill-library-mcp/tree/main/data/perry-workspaces commit 8b55230506

Browse category

Frequently asked questions

npx skillmds@latest add modbender/perry-workspaces