Command Highlights

Complete command reference for the VirtualBoard CLI

Core Commands

Purpose-built for every stage

Purpose-built commands for every stage of your feature lifecycle

Initialize

vb init downloads and expands the VirtualBoard template archive. Use --force to rebuild or --update to interactively update to the latest template version.

New Feature

vb new scaffolds a spec with labels, front-matter, and canonical sections ready for backlog grooming.

Move

vb move enforces workflow transitions and can assign owners in one command.

Update

vb update patches fields or body sections to keep specs synchronised with product decisions.

Validate

vb validate surfaces schema, dependency, and workflow issues early. Add --fix to reapply templates.

Index & Lock

vb index rebuilds stakeholder-friendly views, while vb lock coordinates collaborative edits.

See the full CLI reference for exhaustive command options and exit codes.

New in v0.8.0

Security & Integrity

Hardened internals for production-grade workflows

Audit Logging

Append-only JSONL audit log with SHA-256 hash chain at .virtualboard/audit.jsonl. Every feature operation is recorded with tamper-evident hashes for full traceability.

Checksum-Verified Upgrades

vb upgrade now verifies downloaded binary integrity against SHA-256 checksums before replacing the current binary, preventing supply-chain tampering.

Atomic Lock Files

Lock file creation uses O_CREATE|O_EXCL to prevent TOCTOU race conditions. Concurrent vb lock calls are now safely serialised.

Semantic Version Comparison

Proper semver parsing replaces string-based comparison in vb upgrade. Versions like v1.10.0 are now correctly ranked above v1.9.0.

Built for Teams

Enterprise-grade standards

Quality and security baked into every layer

Quality Gates

Pre-commit hooks and GitHub Actions enforce 100% coverage, gosec scanning, and multi-platform build checks on every change.

Secure by Default

Atomic file operations, strict permissions (0600/0750), and explicit lock semantics keep collaborative workspaces consistent.

Template Driven

The internal/template package codifies VirtualBoard spec expectations, so teams stay aligned on structure and content.