vibectl

A repo-aware engineering copilot in the terminal. Indexes your codebase, builds a dependency graph, and uses LLMs to detect architecture drift, predict bugs, suggest refactors, and more.

Tech Stack

• Language: Python 3.11+
• CLI: Typer, Rich
• LLM Providers: Anthropic, OpenAI, Ollama, Claude Code
• Analysis: tree-sitter (AST parsing), NetworkX (dependency graphs), FAISS (embeddings)
• Storage: SQLite

Install

pip install -e .

Usage

vibectl init            # Initialize in a repo
vibectl index           # Index the codebase
vibectl status          # Project health overview
vibectl arch-drift      # Detect architecture drift
vibectl predict-bug     # Predict likely bugs
vibectl refactor        # Suggest refactors
vibectl flow            # Track development flow
vibectl doctor          # Run diagnostics

Optional extras: pip install -e ".[web]" for the web dashboard, pip install -e ".[embeddings]" for semantic search.