skills$openclaw/perry-workspaces
gricha2.9k

by gricha

perry-workspaces – OpenClaw Skill

perry-workspaces is an OpenClaw Skills integration for coding workflows. 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.

2.9k stars9.7k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

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. OpenClaw Skills integration.
ownergricha
repositorygricha/perry-workspaces
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @gricha/perry-workspaces
last updatedFeb 7, 2026

Maintainer

gricha

gricha

Maintains perry-workspaces in the OpenClaw Skills directory.

View GitHub profile
File Explorer
2 files
.
_meta.json
462 B
SKILL.md
1.3 KB
SKILL.md

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 <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
README.md

No README available.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install perry-workspaces?

Run openclaw add @gricha/perry-workspaces in your terminal. This installs perry-workspaces into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/gricha/perry-workspaces. Review commits and README documentation before installing.