VirtualBoard CLI

Purpose-built Go CLI for feature lifecycle management with validation, indexing, and automation support.

Download VirtualBoard CLI

Installation Instructions:

# Download the binary
curl -L https://github.com/virtualboard/vb-cli/releases/latest/download/vb-macos-arm64 -o vb-macos-arm64

# Move to /usr/local/bin and rename to 'vb'
sudo mv vb-macos-arm64 /usr/local/bin/vb

# Make it executable
sudo chmod +x /usr/local/bin/vb

# Verify installation
vb version

CLI Commands

vb help

Display help information about any command. Shows usage, available commands, and flags.

vb help [command]

vb init

Initialize workspace with VirtualBoard template. Downloads and expands the complete template structure.

vb init

vb new

Create new feature spec with labels and frontmatter ready for backlog grooming.

vb new "User Auth" auth frontend

vb move

Move features between lifecycle states with workflow validation and owner assignment.

vb move FTR-0001 in-progress --owner agent-1

vb update

Patch frontmatter fields or body sections to keep specs synchronized.

vb update FTR-0001 --priority P1

vb validate

Enforce schema, workflow, and dependency rules. Add --fix to reapply templates.

vb validate all --fix

vb index

Rebuild stakeholder-friendly views in Markdown, JSON, and HTML formats.

vb index

vb lock

Manage feature locks to prevent concurrent edits and ensure multi-agent safety.

vb lock FTR-0001

vb delete

Delete a feature spec from the workspace. Use with caution.

vb delete FTR-0001

vb template

Template operations for managing and applying feature spec templates.

vb template list

vb upgrade

Upgrade vb CLI to the latest version automatically.

vb upgrade

vb version

Print the current CLI version information.

vb version

Automation Friendly

All commands support flags for easy integration with CI/CD pipelines and automation tools:

--json

Output results in JSON format for parsing

--dry-run

Preview changes without applying them

--verbose

Show detailed execution information

--root

Specify custom project root directory

Example Workflows

Creating a New Feature

# Create a new feature with labels
vb new "User Authentication" labels auth frontend security

# Output: Created FTR-0123 in features/backlog/

# View the feature
cat features/backlog/FTR-0123-user-authentication.md

Moving Through Lifecycle

# Start working on a feature
vb move FTR-0123 in-progress --owner fullstack_dev

# Move to review when ready
vb move FTR-0123 review

# Mark as complete
vb move FTR-0123 done

Validation & Indexing

# Validate all features
vb validate all

# Fix validation issues automatically
vb validate all --fix

# Regenerate index
vb index