ASD

Mgrep Code Search

Búsqueda semántica de código con mgrep para explorar eficientemente codebases con más de 30 archivos o estructuras de directorios anidadas, complementando grep/ripgrep.

Reemplaza a: grep/ripgrep para búsqueda por intención en codebases grandes

Estrellas
281

en todo el repo

Actividad
26

0–100, la ruta de este skill

Actualizado
hace 6 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
870 tok

92 tok en reposo

Paquete
1 archivo

3 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add intellectronica/agent-skills --skill mgrep-code-search --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Realiza búsquedas semánticas en lenguaje natural sobre código, texto, PDFs e imágenes usando mgrep
  • Indexa el repositorio con bunx @mixedbread/mgrep watch, respetando .gitignore y .mgrepignore
  • Permite refinar búsquedas con opciones como -m, -c, -a y -s, y restringir por ruta

Úsalo cuando

  • El codebase tiene más de 30 archivos no ignorados por git
  • Hay estructuras de directorios anidadas
  • Se busca por concepto, funcionalidad o intención en vez de una cadena exacta
  • Se explora un codebase desconocido o se necesita entender dónde o cómo está implementado algo

No lo uses cuando

  • Se busca un patrón o símbolo exacto
  • Es una refactorización basada en regex
  • Se rastrea un nombre específico de función o variable (usar grep/ripgrep en su lugar)

Qué lo activa

Di cualquiera de estas frases y el agente debería cargar este skill.

  • ¿Dónde está configurada la autenticación en este proyecto?
  • ¿Cómo manejamos los errores en las llamadas a la API?
  • Explora cómo funciona la capa de caché en este codebase
  • Busca semánticamente cómo se procesa el pago en src/services

SKILL.md

En inglés

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

    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:

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

Reproducido de intellectronica/agent-skills bajo licencia CC0-1.0. Leer esta página en markdown.

Archivos

1 archivo en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

Antes de instalar

Requiere ejecutar bunx @mixedbread/mgrep (no npm/npx ni instalación directa) y correr `watch` antes de buscar para mantener el índice actualizado.

Detalles

Licencia
CC0-1.0
Recursos incluidos
Solo SKILL.md
Código fuente
Ver SKILL.md

Etiquetas

Más de intellectronica/agent-skills

Este repo incluye 22 skills. Si instalas uno, normalmente ya tienes los demás.

Úsalo cuando el usuario quiera operar Google Workspace desde la línea de comandos con gog/gogcli: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Chat, Classroom, Contacts, Tasks, Groups, Admin, Keep y auth.

Costo de contexto al activarse
2.2k tok
Tamaño del paquete
9 archivos
Última actualización
hace 3 meses
automatizacion

Úsalo para leer o buscar notas de Monologue mediante su API REST: autenticación con MONOLOGUE_API_KEY, listado, paginación, filtros y manejo de errores, todo por HTTP directo con curl.

Costo de contexto al activarse
1.4k tok
Tamaño del paquete
1 archivo
Última actualización
hace 3 meses
desarrollo apis

Ayuda con el trabajo del GitHub Copilot SDK en Node.js/TypeScript, Python, Go, .NET y Java: setup, autenticación, permisos, streaming, tools personalizadas, custom agents, servidores MCP, hooks, skills y persistencia de sesiones.

Costo de contexto al activarse
3.2k tok
Tamaño del paquete
5 archivos
Última actualización
hace 4 meses
desarrollo apis

Genera y edita imágenes con Nano Banana 2 (Gemini 3.1 Flash Image Preview) de Google, para iteración rápida y control de aspect-ratio y resolución de 512px a 4K.

Costo de contexto al activarse
977 tok
Tamaño del paquete
2 archivos
Última actualización
hace 5 meses
diseno ui

Inicializa un repositorio git con instrucciones opcionales de commit para el agente y un .gitignore.

Costo de contexto al activarse
790 tok
Tamaño del paquete
1 archivo
Última actualización
hace 6 meses
herramientas desarrollo

Instrucciones para interactuar con Todoist mediante la CLI td: operaciones CRUD sobre tareas, proyectos, secciones, etiquetas y comentarios, con confirmación previa a acciones destructivas.

Costo de contexto al activarse
2.3k tok
Tamaño del paquete
3 archivos
Última actualización
hace 6 meses
productividad

Skills relacionados

Úsalo al empezar trabajo de feature que necesita aislamiento del workspace actual, o antes de ejecutar planes de implementación: asegura un workspace aislado vía herramientas nativas o fallback a git worktree.

Costo de contexto al activarse
1.7k tok
Tamaño del paquete
1 archivo
Última actualización
el mes pasado
herramientas desarrollo

Úsala al crear nuevas skills, editar skills existentes o verificar que funcionan antes de desplegarlas.

Costo de contexto al activarse
6.6k tok
Tamaño del paquete
7 archivos
Última actualización
anteayer
herramientas desarrollo

Parte un plan, una spec o la conversación actual en tickets tracer-bullet, cada uno declarando sus aristas de bloqueo, publicados en el tracker configurado.

Costo de contexto al activarse
1.4k tok
Tamaño del paquete
2 archivos
Última actualización
hace 24 días
herramientas desarrollo