mgrep

A calm, CLI-native way to semantically grep everything, like code, images, pdfs and more.

  Your browser does not support the video tag.

Why mgrep?

• Natural-language search that feels as immediate as grep.
• Semantic, multilingual & multimodal (audio, video support coming soon!)
• Web search built-in — query the web alongside your local files with --web.
• Smooth background indexing via mgrep watch, designed to detect and keep up-to-date everything that matters inside any git repository.
• Friendly device-login flow and first-class coding agent integrations.
• Built for agents and humans alike, and designed to be a helpful tool, not a restrictive harness: quiet output, thoughtful defaults, and escape hatches everywhere.
• Reduces the token usage of your agent by 2x while maintaining superior performance

# index once
mgrep watch

# then ask your repo things in natural language
mgrep "where do we set up auth?"

Quick Start

1. **Install**

   npm install -g @mixedbread/mgrep    # or pnpm / bun

2. **Sign in once**

   mgrep login

   A browser window (or verification URL) guides you through Mixedbread authentication.

   **Alternative: API Key Authentication** For CI/CD or headless environments, set the `MXBAI_API_KEY` environment variable:

   export MXBAI_API_KEY=your_api_key_here

   This bypasses the browser login flow entirely.

3. **Index a project**

   cd path/to/repo
   mgrep watch

   `watch` performs an initial sync, respects `.gitignore`, then keeps the Mixedbread store updated as files change.

4. **Search anything**

...