VirtualBoard CLI

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

Download VirtualBoard CLI

Download macOS (Apple Silicon)

Or view all releases

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

Getting Started

Essential commands to begin using VirtualBoard

vb help

Display help information about any command

vb help [command]

vb init

Initialize workspace with VirtualBoard template

vb init

vb version

Print the current CLI version information

vb version

vb upgrade

Upgrade vb CLI to the latest version automatically

vb upgrade

Feature Management

Create, move, update, and manage feature specifications

vb new

Create new feature spec with labels and frontmatter

vb new "User Auth" auth

vb move

Move features between lifecycle states

vb move FTR-001 review

vb update

Patch frontmatter fields or body sections

vb update FTR-001 --priority P1

vb delete

Delete a feature spec from the workspace

vb delete FTR-001

Validation & Indexing

Ensure data integrity and generate stakeholder views

vb validate

Enforce schema, workflow, and dependency rules

vb validate all --fix

vb index

Rebuild views in Markdown, JSON, and HTML formats

vb index

Advanced

Locking and template management for power users

vb lock

Manage feature locks to prevent concurrent edits

vb lock FTR-001

vb template

Manage and apply feature spec templates

vb template list

Automation Friendly

All commands support flags for CI/CD 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

Common patterns for using the CLI effectively

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