
Using Workspaces
- 1 installs
- 9 repo stars
- Updated January 25, 2026
- patricio0312rev/workspaces
Overview and getting-started guide for the workspaces plugin that manages multiple related repositories for microservice or polyrepo setups.
About
Explains how to use the workspaces plugin to manage multiple related repositories, covering init, clone, setup, doctor and status commands. A developer uses it when getting started managing a multi-repo or polyrepo workflow.
- Quick-start flow: init, clone, setup, doctor, status
- Workspace configs stored under ~/.claude/workspaces/<name>/
Using Workspaces by the numbers
- 1 all-time installs (skills.sh)
- Ranked #2,476 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/patricio0312rev/workspaces --skill using-workspacesAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| repo stars | ★ 9 |
| Last updated | January 25, 2026 |
| Repository | patricio0312rev/workspaces ↗ |
What it does
Overview and getting-started guide for the workspaces plugin that manages multiple related repositories for microservice or polyrepo setups.
Files
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
1. Initialize a workspace: /workspaces:init
- Creates a new workspace configuration
- Add your projects with their repos, paths, and ports
2. Clone repositories: /workspaces:clone all
- Clone all configured repos to their designated paths
3. Set up projects: /workspaces:setup all
- Run setup scripts (install deps, migrations, etc.)
4. Verify everything: /workspaces:doctor
- Check prerequisites and run health checks
5. 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 apito see what depends on the API before making breaking changes - Use
/workspaces:search "TODO"to find TODOs across all projects - Run
/workspaces:doctorwhen something isn't working