| name | using-workspaces |
| description | Overview and getting started guide for the workspaces plugin. Use when user asks "how do I use workspaces", "workspaces help", or "getting started with workspaces". |
Skill: Using Workspaces
Description
This skill provides an overview of the workspaces plugin and how to use it effectively for managing multi-project/multi-repo workflows.
Instructions
When the user asks about using the workspaces plugin, provide this overview:
Workspaces Overview
The workspaces plugin helps you manage multiple related repositories that belong to the same company or project. Perfect for teams working with microservices, polyrepos, or any multi-project setup.
Quick Start
-
Initialize a workspace: /workspaces:init
- Creates a new workspace configuration
- Add your projects with their repos, paths, and ports
-
Clone repositories: /workspaces:clone all
- Clone all configured repos to their designated paths
-
Set up projects: /workspaces:setup all
- Run setup scripts (install deps, migrations, etc.)
-
Verify everything: /workspaces:doctor
- Check prerequisites and run health checks
-
Check status: /workspaces:status
- See git status, branches, and running services across all projects
Configuration
Workspace configs are stored in ~/.claude/workspaces/<workspace-name>/:
WORKSPACE.md - Main configuration with projects, relationships, and commands
Available Commands
| Command | Description |
|---|
/workspaces:init | Create a new workspace |
/workspaces:status | Show status across all projects |
/workspaces:clone | Clone repositories |
/workspaces:setup | Run setup scripts |
/workspaces:start | Start services |
/workspaces:stop | Stop services |
/workspaces:affected | Show dependency graph |
/workspaces:search | Search across all projects |
/workspaces:doctor | Check prerequisites and health |
Tips
- Use
/workspaces:affected api to see what depends on the API before making breaking changes
- Use
/workspaces:search "TODO" to find TODOs across all projects
- Run
/workspaces:doctor when something isn't working