bootspring workspace

Multi-project workspace management for monorepos and related projects.

Overview#

The workspace command helps manage multiple related projects, running workflows across all of them and tracking status centrally.

Usage#

bootspring workspace <command> [options]

Commands#

CommandDescription
init [name]Initialize workspace in current directory
add <path>Add a project to workspace
remove <name>Remove a project from workspace
listList all projects
statusShow workspace status
run <workflow>Run workflow across all projects

Options#

OptionDescription
--name <name>Project name (for add)
--tags <tags>Comma-separated tags (for add)
--filter <pattern>Filter projects (for run)
--sequentialRun workflows sequentially
--verboseShow detailed output
--jsonOutput as JSON

Available Workflows#

WorkflowDescription
analyzeRun analysis on all projects
auditAudit all projects
healthCheck health of all projects
generateGenerate context for all
deployDeploy all projects

Examples#

1# Initialize workspace 2bootspring workspace init my-workspace 3 4# Add projects 5bootspring workspace add ../project-a --tags=frontend 6bootspring workspace add ../project-b --tags=backend 7bootspring workspace add ../project-c --tags=shared 8 9# List projects 10bootspring workspace list 11 12# Show status 13bootspring workspace status 14 15# Run analysis on all 16bootspring workspace run analyze 17 18# Run only on frontend projects 19bootspring workspace run health --filter=frontend 20 21# Run sequentially 22bootspring workspace run deploy --sequential 23 24# JSON output 25bootspring workspace list --json

Workspace Structure#

workspace/ ├── workspace.json # Workspace config ├── project-a/ # Frontend project ├── project-b/ # Backend project └── project-c/ # Shared libraries

workspace.json#

1{ 2 "name": "my-workspace", 3 "projects": [ 4 { 5 "name": "project-a", 6 "path": "../project-a", 7 "tags": ["frontend"] 8 }, 9 { 10 "name": "project-b", 11 "path": "../project-b", 12 "tags": ["backend"] 13 } 14 ] 15}

Tags and Filtering#

Use tags to organize and filter projects:

1# Add with tags 2bootspring workspace add ../api --tags=backend,api 3 4# Filter by tag 5bootspring workspace run audit --filter=backend 6 7# Multiple tags 8bootspring workspace run test --filter=frontend,backend