Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vexp-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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              # Force agent config (auto-detect all)
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:   you@example.com
#   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