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 vexp in your project
vexp index         # Index the codebase
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, Zed, Codex, Opencode, Kilo Code, Kiro, Antigravity.

`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.

vexp hooks install    # Install git hooks
vexp hooks check      # Check hook status
vexp hooks remove     # Remove hooks

`vexp init [dir]`

Initialize vexp for a project (creates .vexp/, installs hooks).

vexp init
vexp init /path/to/project

`vexp version`

Show version information.

vexp version
# vexp CLI: 1.2.14
# vexp core: 1.2.14

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
`get_context_capsule`	Most relevant code for your task (semantic + graph search)
`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

Manual MCP Configuration

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

Claude Code (~/.claude.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