vibe.cli.commands¶

CLI command implementations for VIBE.

Contains the actual command logic that gets called by the CLI dispatcher.

ExtensionTemplateSource ¶

Template source directory for an enabled extension.

print_plain ¶

print_plain(color: str, message: str, details: list[str] | None = None) -> None

Print a colored message without status marker.

print_header ¶

print_header(title: str) -> None

Print a section header.

print_component_validation ¶

print_component_validation(component_data: ComponentTemplateData, indent_level: int = 1, show_details: bool = False) -> None

Recursively print component validation results with proper indentation.

Parameters:	`component_data` (`ComponentTemplateData`) – ComponentTemplateData object `indent_level` (`int`, default: `1` ) – Current indentation level (1 = one level indented) `show_details` (`bool`, default: `False` ) – If True, show verbose error details (line numbers, sources)

suppress_stderr ¶

suppress_stderr() -> Generator[None, None, None]

Temporarily suppress stderr to hide rich tracebacks.

suppress_stdout ¶

suppress_stdout() -> Generator[None, None, None]

Temporarily suppress stdout to hide logs.

suppress_noisy_logs ¶

suppress_noisy_logs() -> None

Suppress debug/info logs from noisy modules during validation.

create_template_command ¶

create_template_command(template_name: str) -> None

Create a new template skeleton and register it in the global config.yml.

Actions: 1) Create directory under templates/ 2) Write skeleton config.yml and template.md (simple greeting example) 3) Add entry to root config.yml under template_sources

scaffold_ui_command ¶

scaffold_ui_command(template_id: str | None, targets: list[str], *, force: bool = False, list_only: bool = False) -> None

Scaffold selected UI override files for an existing template.

When targets are provided, copy only those files into the template's override directory. When no targets are given, list available artifacts with short descriptions.

validate_templates_command ¶

validate_templates_command(template_id: str | None = None, details: bool = False, verbose: bool = False) -> None

Validate template definitions and configuration.

Parameters:	`template_id` (`str`, default: `None` ) – Specific template ID to validate. If None, validates all discovered templates. `details` (`bool`, default: `False` ) – If True, show detailed error and warning messages. `verbose` (`bool`, default: `False` ) – If True, show debug/info logs during validation. If False (default), use clean output only.

validate_components_command ¶

validate_components_command(component_id: str | None = None, template_id: str | None = None, details: bool = False, verbose: bool = False) -> None

Validate component definitions and configuration.

Parameters:

component_id (str, default: None ) –

Specific component ID to validate. If None, validates all discovered components.
template_id (str, default: None ) –

Template ID to search for components in. If provided, searches the template's local components directory.
details (bool, default: False ) –

If True, show detailed error and warning messages.
verbose (bool, default: False ) –

If True, show debug/info logs during validation. If False (default), use clean output only.

inspect_state_command ¶

inspect_state_command(filepath: str, no_verify: bool = False) -> None

Inspect a .vibestate file.

Parameters:	`filepath` (`str`) – Path to the .vibestate file `no_verify` (`bool`, default: `False` ) – Skip HMAC signature verification

run_server_command ¶

run_server_command(port: int = 5001, debug: bool = True, use_reloader: bool = False) -> None

Run the VIBE web server.

Parameters:	`port` (`int`, default: `5001` ) – Port to run the server on `debug` (`bool`, default: `True` ) – Enable debug mode `use_reloader` (`bool`, default: `False` ) – Enable auto-reloader

vector_store_command ¶

vector_store_command(subcommand: str, template_id: str | None = None, verbose: bool = False) -> None

Manage vector stores for reference documents.

Parameters:	`subcommand` (`str`) – One of 'list', 'clear', 'info' `template_id` (`str \| None`, default: `None` ) – Optional template ID to filter by `verbose` (`bool`, default: `False` ) – Show detailed information

eval_command ¶

eval_command(template_id: str | None = None, state_path: str | None = None, overrides: list[str] | None = None, locale: str | None = None) -> None

Interactive Jinja/template expression evaluator (REPL).

Parameters:	`template_id` (`str \| None`, default: `None` ) – Template ID to load context from `state_path` (`str \| None`, default: `None` ) – Path to .vibestate file to load `overrides` (`list[str] \| None`, default: `None` ) – List of VAR=VALUE strings to override variables `locale` (`str \| None`, default: `None` ) – Locale for linguistic filters (default: from config or 'en')