vexp CLI

Graph-RAG context engine for AI coding agents. Indexes your codebase and provides intelligent context to AI tools via MCP (Model Context Protocol).

Install

npm install -g vexp-cli

Requires Node.js >= 20. The platform-specific binary is installed automatically via npm.

Quick Start

# One-command setup: index codebase + detect & configure AI agents
vexp setup

# Or step by step:
vexp init              # Initialize and index your project
vexp setup --no-index  # Configure agents only (skip indexing)

Commands

vexp setup [dir]

Complete one-command setup: index, detect AI agents, configure MCP.

vexp setup                    # Current directory
vexp setup /path/to/project   # Specific directory
vexp setup --no-index         # Skip indexing (already indexed)
vexp setup --agents claude,cursor  # Configure specific agents only
vexp setup --dry-run          # Preview what would be configured

Auto-detects and configures: Claude Code, Cursor, Windsurf, GitHub Copilot, Continue.dev, Augment, Zed, Codex, Opencode, Kilo Code, Kiro, Antigravity.

vexp init [dir]

Initialize vexp for a project (index, create .vexp/, install hooks).

vexp init
vexp init /path/to/project

vexp index [dir]

Index a directory for code intelligence.

vexp index                  # Index current directory
vexp index --watch          # Watch for changes and re-index
vexp index --status         # Show indexing status

vexp capsule <query>

Generate a context capsule for a task or question.

vexp capsule "fix the login bug"
vexp capsule "how does auth work" --max-tokens 12000
vexp capsule "add caching" --format json
vexp capsule "refactor" --repos frontend,backend

vexp skeleton <file>

Print a token-efficient skeleton of a file (signatures, types, no bodies).

vexp skeleton src/auth.ts
vexp skeleton src/api.rs --detail detailed
vexp skeleton src/utils.py --detail minimal

vexp impact <fqn>

Show what breaks if you change a symbol.

vexp impact "src/auth.ts::validateToken"
vexp impact "src/db.rs::query" --depth 10
vexp impact "src/api.ts::handler" --format mermaid
vexp impact "src/shared.ts::Config" --cross-repo

vexp flow <start> <end>

Find execution paths between two symbols.

vexp flow "src/api.ts::handleRequest" "src/db.ts::query"
vexp flow "main" "save" --max-paths 5
vexp flow "handler" "db::insert" --cross-repo

vexp mcp

Start the MCP server over stdin/stdout (used by AI coding agents).

vexp mcp                         # In-process mode
vexp mcp --workspace /path       # Specify workspace
vexp mcp --proxy                 # Connect to existing daemon

vexp daemon

Start the vexp background daemon.

vexp daemon --workspace /path/to/project

vexp daemon-cmd <action>

Manage the daemon.

vexp daemon-cmd start
vexp daemon-cmd stop
vexp daemon-cmd status
vexp daemon-cmd logs --follow

vexp hooks <action>

Manage git hooks for automatic index updates. Hooks use marker-delimited sections (# --- vexp start/end ---) that coexist with existing hooks (husky, lint-staged, etc.).

vexp hooks install    # Install git hooks (appends to existing hooks)
vexp hooks check      # Check hook status
vexp hooks remove     # Remove hooks (only vexp section, preserves your hooks)

vexp activate [key]

Activate a Pro or Team license key. The license is shared with the VS Code extension via ~/.vexp/license.jwt.

vexp activate <license-key>
# ✓ License activated!
#   Plan:    pro
#   Email:   [email protected]
#   Expires: 2027-02-28

vexp deactivate

Remove the current license and revert to Free plan limits.

vexp deactivate
# License removed. Free plan limits are now active.

vexp license

Show current license status and active limits.

vexp license
# Plan:      pro
# Max nodes: 50,000
# Max repos: 3
# All tools: yes

vexp version

Show version information.

vexp version
# vexp CLI: 1.2.16
# vexp core: 1.2.16

MCP Integration

vexp provides context to AI coding agents via MCP. After running vexp setup, your agents are auto-configured with these tools:

| Tool | Description | |------|-------------| | run_pipeline | Primary tool. Context + impact + memory in one call. Auto-detects intent. | | get_context_capsule | Lightweight context search for quick lookups | | get_impact_graph | What breaks if you change a symbol | | search_logic_flow | Execution paths between functions | | get_skeleton | Token-efficient file structure | | index_status | Indexing health check | | get_session_context | Recall observations from current/previous sessions | | search_memory | Cross-session search for past decisions | | save_observation | Persist insights with code symbol linking |

The CLI enforces the same Free/Pro/Team limits as the VS Code extension. Free plan: run_pipeline runs without impact/flow steps. Pro/Team: full pipeline.

Manual MCP Configuration

If you prefer to configure MCP manually instead of using vexp setup:

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "vexp": {
      "command": "vexp",
      "args": ["mcp", "--workspace", "/path/to/project"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "vexp": {
      "command": "vexp",
      "args": ["mcp", "--workspace", "/path/to/project"]
    }
  }
}

Supported Platforms

| Platform | Architecture | |----------|-------------| | Linux | x64, ARM64 | | macOS | x64, ARM64 (Apple Silicon) | | Windows | x64 |

License

MIT