mcpField
M
mgrep-code-search

mgrep-code-search

github.com/intellectronicaDevelopment298621 installsUpdated 27w ago
Repository

About mgrep-code-search

mgrep-code-search is a skill for semantic searches across code and other repository files using natural-language queries. It helps developers explore unfamiliar or complex codebases by finding implementations by concept rather than exact text.

Key features

  1. 01Natural-language semantic search
  2. 02Search code, text, PDFs, and images
  3. 03Index and watch repository changes
  4. 04Filter by path and result count
  5. 05Display matches or AI synthesis

Use cases

  1. 01Locate where a feature is implemented
  2. 02Explore an unfamiliar codebase
  3. 03Find concepts across nested directories

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/intellectronica/agent-skills --skill mgrep-code-search

After installing, type/mgrep-code-searchin Claude Code to confirm it loaded.

Details

From the project README

mgrep Code Search

Overview

mgrep is a semantic search tool that enables natural language queries across code, text, PDFs, and images. It is particularly effective for exploring larger or complex codebases where traditional pattern matching falls short.

When to Use This Skill

Use mgrep when:

  • The codebase contains more than 30 non-gitignored files
  • There are nested directory structures
  • Searching for concepts, features, or intent rather than exact strings
  • Exploring an unfamiliar codebase
  • Need to understand "where" or "how" something is implemented

Use traditional grep/ripgrep when:

  • Searching for exact patterns or symbols
  • Regex-based refactoring
  • Tracing specific function or variable names

Quick Start

Indexing

Before searching, start the watcher to index the repository:

bunx @mixedbread/mgrep watch

The watch command indexes the repository and maintains synchronisation with file changes. It respects .gitignore and .mgrepignore patterns.

Searching
bunx @mixedbread/mgrep "your natural language query" [path]

Search Commands

Basic Search
bunx @mixedbread/mgrep "where is authentication configured?"
bunx @mixedbread/mgrep "how do we handle errors in API calls?" src/
bunx @mixedbread/mgrep "database connection setup" src/lib
Search Options
OptionDescription
-m <count>Maximum results (default: 10)
-c, --contentDisplay full result content
-a, --answerGenerate AI-powered synthesis of results
-s, --syncUpdate index before searching
--no-rerankDisable relevance optimisation
Examples with Options
# Get more results
bunx @mixedbread/mgrep -m 25 "user authentication flow"

# Show full content of matches
bunx @mixedbread/mgrep -c "error handling patterns"

# Get an AI-synthesised answer
bunx @mixedbread/mgrep -a "how does the caching layer work?"

# Sync index before searching
bunx @mixedbread/mgrep -s "payment processing" src/services

Workflow

  1. Start watcher (once per session or when files change significantly):

    bunx @mixedbread/mgrep watch

  2. Search semantically:

    bunx @mixedbread/mgrep "what you're looking for" [optional/path]

  3. Refine as needed using path constraints or options:

    bunx @mixedbread/mgrep -m 20 -c "refined query" src/specific/directory

Environment Variables

Configure defaults via environment variables:

VariablePurpose
MGREP_MAX_COUNTDefault result limit
MGREP_CONTENTEnable content display (1/true)
MGREP_ANSWEREnable AI synthesis (1/true)
MGREP_SYNCPre-search sync (1/true)

Important Notes

  • Always use bunx @mixedbread/mgrep to run commands (not npm/npx or direct installation)
  • Run bunx @mixedbread/mgrep watch before searching to ensure the index is current
  • mgrep respects .gitignore patterns automatically
  • Create .mgrepignore for additional exclusions

Comments

Markdown supported