CLI
Workspace Guide
Track multiple repos under one folder and keep new repos synced automatically.
Updated 2026-02-11
Use workspaces when you have many repositories in one parent folder.
Why use workspaces
- Link and track many repos in one step
- New repos under that folder can be discovered on future syncs
- Better for monorepos plus service repos setup
Add a workspace
workrail workspace add ~/Projects
Optionally set discovery depth:
workrail workspace add ~/Projects --depth 8
List workspaces
workrail workspace list
Remove a workspace
workrail workspace remove
Recommended flow
- Add workspace
- Run
workrail sync - Verify linked repos in
workrail status
Notes
- Workspace sync does not backfill by default
- Use
--sinceonly when you intentionally want backfill