# Vexi

> Open-source AI coding agent for your terminal. Bring your own key, zero config, 100% local.

Vexi is a free, open-source CLI tool that brings AI coding assistance directly into your terminal. It works with any API key (Anthropic, OpenAI, Groq, Google Gemini, OpenRouter), runs entirely on your machine, and requires no account or server.

## Install

```bash
npm install -g vexi-cli
vexi
```

## Key features

- **BYOK (Bring Your Own Key)**: Auto-detects your provider from the key format. Supports Anthropic Claude, OpenAI, Groq, Google Gemini, OpenRouter, and Mistral.
- **Context Compression Engine**: Keeps a running summary of your decisions across sessions. Never re-explains your project.
- **Full project understanding**: Scans the entire codebase on startup (respects .gitignore, skips node_modules) and injects a compact map into every AI prompt.
- **Multi-language build support**: Runs pip install, gcc, javac, cargo, gradle, and more directly from chat. Works with Python, Java, C, C++, Rust, Go, and JavaScript.
- **Multilingual**: UI and code explanations in Arabic (ar), English (en), Spanish (es), Portuguese (pt), French (fr).
- **Session replay**: Every session recorded locally; export as interactive standalone HTML.
- **Custom skills**: Drop `.md` files in `.vexi/skills/` to teach Vexi your conventions.
- **Visual dependency graph**: Interactive d3 force-directed graph exported as a single HTML file.
- **MCP support**: Works as both an MCP client (connects to external tools) and MCP server (exposes Vexi capabilities to Claude Desktop, Cursor, etc.).
- **Vexi Learn**: Mines past sessions for your corrections and builds a personal style skill file.

## Privacy

- Your API key is stored locally at `~/.vexi/config.json` (chmod 600). Never sent to Vexi servers.
- Your code is sent only to the AI provider whose key you supply.
- No telemetry, no analytics, no accounts.

## Links

- Website: https://vexi.pro
- npm: https://www.npmjs.com/package/vexi-cli
- GitHub: https://github.com/Elomami1976/vexi
- Contact: hello@vexi.pro
- License: MIT