Reference Documentation

Complete technical reference for SpecFact CLI.

Available References

Commands - Complete command reference with all options
Thorough Codebase Validation - Quick check, contract-decorated, sidecar, and dogfooding
Command Syntax Policy - Source-of-truth argument syntax conventions for docs
Authentication - Device code auth flows and token storage
Architecture - Technical design, module structure, and internals
Debug Logging - Where and what is logged when using --debug
Operational Modes - CI/CD vs CoPilot modes
Specmatic API - Specmatic integration API reference (functions, classes, integration points)
Telemetry - Opt-in analytics and privacy guarantees
Feature Keys - Key normalization and formats
Directory Structure - Project structure and organization
Schema Versioning - Bundle schema versions and backward compatibility (v1.0, v1.1)
Module Security - Marketplace/module integrity and publisher metadata

specfact import from-bridge --adapter speckit - Import from external tools via bridge adapter
specfact import from-code <bundle-name> - Reverse-engineer plans from code
specfact plan init <bundle-name> - Initialize new development plan
specfact plan compare - Compare manual vs auto plans
specfact enforce stage - Configure quality gates
specfact repro - Run full validation suite
specfact sync bridge --adapter <adapter> --bundle <bundle-name> - Sync with external tools via bridge adapter
specfact spec validate [--bundle <name>] - Validate OpenAPI/AsyncAPI specifications
specfact spec generate-tests [--bundle <name>] - Generate contract tests from specifications
specfact spec mock [--bundle <name>] - Launch mock server for development
specfact init ide --ide <cursor|vscode|copilot|...> - Initialize IDE integration explicitly
specfact module install <name|namespace/name> - Install marketplace module (bare names normalize to specfact/<name>)
specfact module list [--source ...] [--show-origin] - List modules with trust/publisher and optional origin details
specfact module show <name> - Show detailed module metadata and full command tree with short descriptions
specfact module search <query> - Search marketplace and installed modules
specfact module uninstall <name|namespace/name> / specfact module upgrade [<name>|--all] - Manage module lifecycle with source-aware behavior

specfact init ide --ide <cursor|vscode|copilot|...> - Set up slash commands in IDE
See IDE Integration Guide for details