vibe-dev - VIBE Developer Toolkit¶

Auto-generated by vibe-dev help --write-md. Do not edit manually.

Usage¶

vibe-dev [GLOBAL OPTIONS] <group> <command> [ARGS...]

Groups and Commands¶

static¶

Static analysis and typing helpers

Commands: - static analyze: Run fast, deterministic static analysis - static missing-types: Report missing or weak type annotations - static typecheck: Run mypy type checker on the codebase

vfs¶

Virtual File System helpers

Commands: - vfs component-loading: Debug VFS component loading - vfs module-load: Debug Python module loading via VFS - vfs path-test: Run VFS path operations checks

docx¶

DOCX debugging utilities

Commands: - docx component-render: Render a DOCX component - docx download-debug: Debug DOCX download workflow - docx insert-debug: Debug insert() behavior in DOCX templates - docx subdoc-test: Test subdoc object handling - docx read: Read and display DOCX content - docx edit: Perform scripted DOCX edits

assistant¶

Assistant workflow utilities

Commands: - assistant replay: Replay assistant recordings - assistant filter-log: Filter assistant logs by key/value - assistant summarize: Summarize assistant log output - assistant playground: Interactive assistant playground - assistant rotate-keys: Rotate API keys for VIBE LLM providers.

Creates new environment-scoped keys named {env}-{YYYY-MM} and
outputs them in .env format to stdout.  Status messages go to
stderr so you can redirect stdout to a file.


Auth methods by provider:
  Vault (--vault=env or --vault=bw):
    OpenAI     — admin API key (sk-admin-...) from vault
    Scaleway   — root access key + secret key from vault
  CLI tools (manage their own auth):
    Google     — gcloud CLI (gcloud auth login)
    Berget     — berget CLI (npx berget auth login)
  Manual (guided step-by-step):
    Anthropic  — create key at console.anthropic.com
    Mistral    — create key at console.mistral.ai


Examples:
  # Dry run to see what would happen
  vibe-dev dev rotate-keys --env dev-staffan --dry-run

  # Using env vars for admin credentials
  OPENAI_ADMIN_KEY=sk-admin-... \
  SCW_ROOT_ACCESS_KEY=SCW... \
  SCW_ROOT_SECRET_KEY=... \
    vibe-dev dev rotate-keys --env dev-staffan --retire-old

  # Using Bitwarden vault for admin credentials
  export BW_SESSION=$(bw unlock --raw)
  vibe-dev dev rotate-keys --env dev-staffan --vault=bw --retire-old

  # Skip manual providers (useful in CI)
  vibe-dev dev rotate-keys --env ci-gitlab --auto-only --retire-old

llm¶

LLM provider utilities

Commands: - llm ask: Send prompts to a local Ollama server - llm parse-logs: Parse assistant logs with the C# log parser

perf¶

Performance utilities

Commands: - perf run: Run performance analysis on probing - perf baseline: Establish or compare a performance baseline

code¶

Codebase utilities

Commands: - code concatenate: Concatenate source files into a single file - code add-docstrings: Add docstrings using heuristics - code cleanup-docstrings: Remove or repair poor docstrings - code move-infunction-imports: Move imports to module top and fix cycles

review¶

Review system developer tools

Commands: - review logs: Inspect structured review logs - review logs filter: Filter structured review logs by assessment metadata and stage. - review logs summarize: Summarize structured review logs for human inspection. - review docs: Inspect and round-trip stored review documents - review docs inspect: Inspect document parts and structure. - review docs export: Export a document and its parts to JSON. - review docs import: Import a document and its parts from JSON. - review parse: Debug parsing pipeline output - review parse doc: Parse a document and output structured parts as JSON. - review parse validate: Validate parsing output against a golden record. - review parse yolo-layout: Run YOLO layout detection on a PDF - review eval: Evaluate review system quality - review eval benchmark: Benchmark retrieval and assessment quality against golden records. - review eval agreement: Summarize human agreement with AI review suggestions. - review db: Developer database access - review db shell: Open an interactive psql shell to the review database. - review golden: Lint and validate review golden records - review golden lint-parse: Lint parsing golden.yml files - review golden lint-assessment: Lint golden-assessment.yml files. - review lab: Interactive developer playgrounds - review lab playground: Interactive review playground

pdf¶

Generic PDF inspection utilities

Commands: - pdf dump-text: Dump raw extracted text from a PDF. - pdf strip-text: Remove text layer from PDF, preserving images. - pdf create-wordlist: Build a Tesseract wordlist from a set of PDFs. - pdf ocr-test-grid: Evaluate OCR quality. For Tesseract: tests OEM/PSM grid.

token¶

PASETO token diagnostics

Commands: - token stats: Show token replay-prevention store statistics.

example¶

Example extension commands

Commands: - example hello: Print a greeting from an extension.

Notes¶

Run vibe-dev <group> <command> -h for command-specific options.
Extensions registered under tools/extensions/ appear as additional groups.