# 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.

- Skill: `kbarbel640-del/perry-workspaces` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/perry-workspaces`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/perry-workspaces/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/perry-workspaces

---


# 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 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