🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Perry Workspaces

by @gricha

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.

Versionv1.1.0
Downloads3,070
Installs7
Stars⭐ 2
TERMINAL
clawhub install perry-workspaces

πŸ“– About This Skill


name: perry-workspaces description: 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.

Perry Workspaces

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

Commands

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

SSH Access

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

Coding Agents

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

    Projects clone to ~/, 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
  • πŸ“‹ Tips & Best Practices

  • 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