npm - vexp-cli - Versions diffs - 2.3.1 → 2.5.0 - Mend

vexp-cli 2.3.1 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md CHANGED Viewed

@@ -1,108 +1,78 @@
-# vexp — Context Engine for AI Coding Agents
+# vexp-cli — Context Engine for AI Coding Agents (Claude Code, Cursor, Codex)
-**58% Less Cost. 90% Fewer Tool Calls. 100% On Your Machine.**
+**Give your AI coding agent the right context, then verify its work — 100% on your machine.**
-vexp is a local-first context engine that gives AI coding agents the right code context — automatically. One install, and every agent gets smarter answers with fewer tokens.
+`vexp-cli` is a local-first [MCP server](https://modelcontextprotocol.io) that pre-indexes your codebase into a dependency graph and feeds any AI coding agent only the code that matters for the task — cutting **87% of the tokens** it would otherwise waste reading whole files. New in 2.5: it also checks the agent's work mechanically when it says it's done, and scans your code for PII and secrets before any model reads them. Your source never leaves your laptop.
-Works with **14+ AI coding agents** and **30 programming languages** out of the box.
+```bash
+npm install -g vexp-cli
+vexp setup      # auto-configures Claude Code, Cursor, Codex, and 14 agents
+vexp index      # builds the local graph — no login, no API key
+```
-→ [SWE-bench Verified: 73% pass@1 at $0.67/task](https://vexp.dev/benchmark)
+[![npm version](https://img.shields.io/npm/v/vexp-cli?color=CB3837)](https://www.npmjs.com/package/vexp-cli)
+[![downloads](https://img.shields.io/npm/dm/vexp-cli?color=CB3837)](https://www.npmjs.com/package/vexp-cli)
+![local-first](https://img.shields.io/badge/code-never%20leaves%20your%20machine-brightgreen)
-## Why vexp?
+---
-AI coding agents waste more than half their budget exploring codebases before writing a single line of code — 23 tool calls on average just to orient themselves. vexp pre-indexes your project into a dependency graph and delivers only the code that matters, ranked by relevance.
+## Why developers install vexp
-- **23 tool calls → 2** — the agent stops guessing and starts coding
-- **$0.78 → $0.33 per task** — measured on SWE-bench Verified
-- **117s → 74s per task** — less context to process = faster answers
-- **Local-first** — your code never leaves your machine
-- **Zero config** — auto-detects your agents and configures MCP
-- **Universal** — works with any agent that supports MCP or custom rules
-- **Optional local AI** — unlock +30% extra savings with `vexp-devmind`, a ~3.5 GB model that runs 100% on your machine. GPU-accelerated on NVIDIA (CUDA) and Apple Silicon (Metal). Opt in with one command.
+Your AI agent burns most of its budget exploring your repo before writing a line of code. It reads entire files, floods its context window, and still misses the one function that mattered. vexp fixes the input **and** the output:
-## Supported AI Coding Agents
+- **⚡ 87% fewer tokens per call.** vexp returns ranked pivot files with exact line ranges and blast radius — not whole files. Measured on real usage, not a synthetic benchmark.
+- **🔍 Verifies the work (new in 2.5).** When your agent declares a task done, `verify_done` reports what's provably broken or missing — broken imports, parse errors, dependents never updated — each with file and line. No model grades anything; it's git + tree-sitter + the code graph.
+- **🛡️ Shield scan (new in 2.5).** `vexp shield scan` shows the emails, API keys, tokens and private keys sitting in your comments and strings that every AI agent currently reads. Local, deterministic, masked.
+- **🔒 100% local.** Zero network calls, zero cloud indexing, no account, no API key. Your code stays yours.
+- **🤝 Works with everything.** One `vexp setup` configures Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Zed, Cline, Aider, opencode, and more — 14 agents in total.
-| Agent | Auto-Configured |
-|-------|:-:|
-| Claude Code | ✓ |
-| Cursor | ✓ |
-| Windsurf | ✓ |
-| GitHub Copilot | ✓ |
-| Continue.dev | ✓ |
-| Augment | ✓ |
-| Zed | ✓ |
-| Codex (OpenAI) | ✓ |
-| Cline | ✓ |
-| Aider | ✓ |
-| Kilo Code | ✓ |
-| Kiro | ✓ |
-| Antigravity | ✓ |
-| Opencode | ✓ |
+## How it works
-Your agents don't compete with each other — they all share the same context layer.
+vexp parses **34 languages** with tree-sitter into a local SQLite dependency graph, then serves your agent through the Model Context Protocol:
-## Supported Languages (30)
+- `run_pipeline` — ranked pivot files + line ranges + blast radius, in one call
+- `get_skeleton` — file structure at 70-90% token savings
+- `verify_done` — mechanical completion check
+- `expand_vexp_ref` — full symbol bodies on demand
-TypeScript, JavaScript, Python, Go, Rust, Java, C#, C, C++, Ruby, Kotlin, Scala, Swift, Dart, Elixir, Haskell, OCaml, Lua, R, PHP, Zig, HCL/Terraform, Objective-C, Bash/Shell, Dockerfile, Clojure, F#, SQL, HTML/CSS, YAML/JSON
+You never call these yourself — `vexp setup` writes the agent config, and your agent calls them automatically. You don't even mention vexp in your prompts.
-## Quick Start
+## Quickstart
 ```bash
+# 1. Install
 npm install -g vexp-cli
-vexp
-```
-That's it. The interactive CLI guides you through setup, indexing, and agent configuration.
-## What You Get
-- **Semantic + graph-ranked context** — finds the right symbols even when keywords don't match
-- **Intent detection in 15 languages** — English, Italian, French, German, Spanish, Portuguese, Russian, Chinese, Japanese, Korean, Arabic, Hindi, Turkish, Dutch, Polish
-- **Cross-session memory** — your agent picks up exactly where it left off, even days later
-- **Stale-knowledge alerts** — when code changes, outdated memory is automatically flagged
-- **Pattern & anti-pattern detection** — recurring changes surface as guidelines; dead-end explorations get flagged early
-- **Change awareness** — files frequently modified together are automatically linked
-- **Security filter** — `.env`, credentials, and SSH keys are excluded automatically
-## Platforms
+# 2. Configure your agents (auto-detected) + build the graph
+cd your-project
+vexp setup
+vexp index
-Native binaries — no runtime dependencies:
+# 3. Use your agent normally. That's it.
+#    Check savings any time:
+vexp savings
-| Platform | Architecture | GPU Acceleration |
-|----------|:-:|:-:|
-| Linux | x64, ARM64 | CUDA (NVIDIA) |
-| macOS | x64, ARM64 (Apple Silicon) | Metal (built-in) |
-| Windows | x64 | CUDA (NVIDIA) |
+# 4. See what your code exposes to AI:
+vexp shield scan
-GPU acceleration applies to the optional local AI layer. Vexp's core context engine runs on any modern CPU.
-## VS Code Extension
-For the best experience, install the [vexp VS Code extension](https://marketplace.visualstudio.com/items?itemName=Vexp.vexp-vscode) — it manages the daemon automatically and adds a sidebar dashboard with token savings tracking.
-## Local AI — Optional +30% Savings
+# 5. Diagnose anything:
+vexp doctor
+```
-Turn on `vexp-devmind` — a code-specialised AI model that runs entirely on your machine — for an extra +30% token savings on top of the baseline.
+## Supported agents
-- **100% local** — the model never calls out. Your code stays on your hardware.
-- **GPU-accelerated** — Metal on Apple Silicon, CUDA on NVIDIA. Auto-detected.
-- **One-command install** — ~3.5 GB one-time download. Minimum 6 GB RAM.
-- **Always up to date** — `--check-updates` compares your local version to the published release without downloading anything.
+Claude Code · Cursor · Windsurf · GitHub Copilot · OpenAI Codex · Zed · Continue.dev · Cline · Aider · Kiro · Kilo Code · opencode · Augment · Antigravity
-Sharper context ranking, higher-quality session memory, smarter prompt preprocessing. All without sending a single byte to any server.
+## Supported languages
-```bash
-vexp setup-llm --install        # ~3.5 GB one-time download
-vexp setup-llm --check-updates  # no-op if already up to date
-vexp setup-llm --status         # show current config + hardware
-vexp setup-llm --disable        # turn it off any time
-```
+TypeScript, JavaScript, Python, Rust, Go, Java, Kotlin, Scala, C, C++, C#, Ruby, PHP, Swift, Objective-C, Lua, Dart, Elixir, Clojure, Haskell, OCaml, F#, Zig, Bash, SQL, and more — 34 in total.
 ## Links
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Vexp.vexp-vscode)
-- [Website](https://vexp.dev)
+- 🌐 Website & docs → [vexp.dev](https://vexp.dev)
+- 🧩 VS Code / Cursor extension → [Marketplace](https://marketplace.visualstudio.com/items?itemName=vexp.vexp-vscode) · [Open VSX](https://open-vsx.org/extension/vexp/vexp-vscode)
+- 🐛 Issues → [github.com/Vexp-ai/vexp/issues](https://github.com/Vexp-ai/vexp/issues)
-## License
+---
-MIT
+**Keywords:** ai context engine · mcp server · claude code context · cursor context · save tokens · reduce ai coding cost · code context · dependency graph · tree-sitter · local-first · token optimization · ai coding assistant · code intelligence · model context protocol