Skip to content

Perry Workspaces

Verified

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.

1,157

Install

Claude Code

Add to .claude/skills/

About This Skill

# Perry Workspaces

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

Commands ```bash perry start <name> --clone [email protected]: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 shell` then `claude`)

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

Use Cases

  • Generate structured output from specifications or requirements
  • Manage workspace configurations and project settings
  • Integrate AI capabilities into workflows with Perry Workspaces
  • Leverage machine learning models for intelligent automation
  • Integrate Perry Workspaces into existing development and automation workflows

Pros & Cons

Pros

  • + Well-adopted with 2,314+ downloads showing reliable real-world usage
  • + Clean CLI interface integrates well with automation pipelines and AI agents
  • + Leverages AI models for intelligent automation beyond simple rule-based tools
  • + Configurable parameters allow tuning for different quality and cost tradeoffs

Cons

  • - Depends on external AI model APIs which may incur usage costs
  • - Output quality varies based on input specificity and model capabilities

Frequently Asked Questions

What does Perry Workspaces do?

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.

What platforms support Perry Workspaces?

Perry Workspaces is available on Claude Code, OpenClaw.

What are the use cases for Perry Workspaces?

Generate structured output from specifications or requirements. Manage workspace configurations and project settings. Integrate AI capabilities into workflows with Perry Workspaces.

Stay Updated on Agent Skills

Get weekly curated skills + safety alerts