SkillsAdd

intellectronica/agent-skills

mgrep-code-search

Semantic code search using mgrep for efficient codebase exploration.

First seen Jan 20, 2026

Installation

$ npx skills add intellectronica/agent-skills --skill mgrep-code-search
View on skills.sh ↗ GitHub repository ↗

Summary

  • Semantic code search using mgrep for efficient codebase exploration.
  • This skill should be used when searching or exploring codebases with more than 30 non-gitignored files and/or nested directory structures.
  • It provides natural language semantic search that complements traditional grep/ripgrep for finding features, understanding intent, and exploring unfamiliar code.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from intellectronica/agent-skills · top by installs.

npx skills add intellectronica/agent-skills
notion-api 73.7K context7 10.8K youtube-transcript 3.3K nano-banana-pro 3.1K ultrathink 1.9K beautiful-mermaid 1.8K todoist-api 1.7K markdown-converter 1.6K anki-connect 830 nano-banana-2 804

Browse all from intellectronica/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 292
License LICENSE.txt
Default branch main
Open issues 1
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,481 B
  • docs SUMMARY.md 394 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 613 installs

SKILL.md

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

Option Description
-m <count> Maximum results (default: 10)
-c, --content Display full result content
-a, --answer Generate AI-powered synthesis of results
-s, --sync Update index before searching
--no-rerank Disable 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):

``bash bunx @mixedbread/mgrep watch ``

  1. Search semantically:

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

  1. Refine as needed using path constraints or options:

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

Environment Variables

Configure defaults via environment variables:

Variable Purpose
MGREPMAXCOUNT Default result limit
MGREP_CONTENT Enable content display (1/true)
MGREP_ANSWER Enable AI synthesis (1/true)
MGREP_SYNC Pre-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