tomevault-io 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 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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.