How do I install the Mgrep Code Search skill?

Run npx skillmds@latest add mkurman/mgrep-code-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mgrep Code Search safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mgrep Code Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mgrep Code Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mgrep Code Search?

mkurman (@mkurman) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mgrep Code Search by mkurman — Agent Skill

Name: Mgrep Code Search
Author: mkurman

Mgrep Code Search

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.

mkurman 5ce78e5 2.0 KB Updated Sep 17, 2026

File contents

--|-------------| | -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

Start watcher (once per session or when files change significantly):
```
bunx @mixedbread/mgrep watch
```

Search semantically:

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

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:

Variable	Purpose
`MGREP_MAX_COUNT`	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

---name: mgrep-code-searchdescription: 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.-----|-------------|| `-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```bash# Get more resultsbunx @mixedbread/mgrep -m 25 "user authentication flow"# Show full content of matchesbunx @mixedbread/mgrep -c "error handling patterns"# Get an AI-synthesised answerbunx @mixedbread/mgrep -a "how does the caching layer work?"# Sync index before searchingbunx @mixedbread/mgrep -s "payment processing" src/services```## Workflow1. **Start watcher** (once per session or when files change significantly): ```bash bunx @mixedbread/mgrep watch ```2. **Search semantically**: ```bash bunx @mixedbread/mgrep "what you're looking for" [optional/path] ```3. **Refine as needed** using path constraints or options: ```bash bunx @mixedbread/mgrep -m 20 -c "refined query" src/specific/directory ```## Environment VariablesConfigure defaults via environment variables:| Variable | Purpose ||----------|---------|| `MGREP_MAX_COUNT` | 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

Frequently asked questions