Permite que los agentes de programación realicen búsquedas con ripgrep conscientes de los tokens y ediciones atómicas en múltiples archivos para reducir el uso de la ventana de contexto.
También conocido como BasilSkyWalk/parecode
- Stars
- 5
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.7.0
- Último commit
- 14 sept 2026
- Licencia
- MIT
¿Qué es parecode MCP?
parecode es un MCP server. Permite que los agentes de programación realicen búsquedas con ripgrep conscientes de los tokens y ediciones atómicas en múltiples archivos para reducir el uso de la ventana de contexto.
Resumen generado a partir del README del proyecto
Acerca del MCP server de parecode
Los agentes de programación que necesitan navegar por bases de código extensas sin agotar la ventana de contexto pueden usar parecode para realizar búsquedas conscientes de los tokens y ediciones en múltiples archivos. Al utilizar la instalación de ripgrep del sistema, el servidor proporciona herramientas como ParecodeSearch y ParecodeEdit que consolidan múltiples llamadas de herramientas tradicionales en operaciones únicas y eficientes. Este enfoque está diseñado para reducir tanto el consumo de tokens como el número de turnos necesarios para completar tareas complejas de refactorización.
Los desarrolladores que usan Claude Code pueden configurar el servidor localmente vía npm. El proceso de instalación incluye un hook SessionStart opcional para priorizar estas herramientas especializadas y un plugin parecode-explore que utiliza un subagente más económico para preguntas de tipo exploración. El sistema opera completamente en la máquina local sin llamadas de red ni telemetría, lo que garantiza que los datos del código y los logs de la sesión permanezcan privados. Los usuarios pueden monitorear su eficiencia a través de logs de sesión locales que estiman los tokens ahorrados.
Qué puedes hacer con él
- 1Refactorización eficiente de múltiples archivosUn agente puede encontrar cada sitio de llamada de un símbolo específico en varios archivos y aplicar cambios en todos ellos en un solo lote.
- 2Exploración de código consciente del contextoUn desarrollador puede preguntar dónde se encuentra un componente específico o cómo funciona una función usando un subagente de bajo costo para ahorrar tokens de la sesión principal.
- 3Búsqueda de código dirigidaBusca múltiples patrones relacionados simultáneamente para rastrear flujos de eventos sin ejecutar comandos grep por separado.
- 4Expansión de resultados de búsquedaDespués de encontrar una línea específica de interés, un agente puede ampliar el rango de código visible sin tener que volver a leer el archivo completo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar parecode MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar parecode MCP en Claude Code
$ claude mcp add parecode -- npx -y parecodeInstalar parecode MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Instalar parecode MCP en VS Code
.vscode/mcp.json
{
"servers": {
"parecode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Instalar parecode MCP en VS Code CLI
$ code --add-mcp '{"name":"parecode","type":"stdio","command":"npx","args":["-y","parecode"]}'Instalar parecode MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Instalar parecode MCP en Codex
$ codex mcp add parecode -- npx -y parecodeInstalar parecode MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.parecode] command = "npx" args = ["-y", "parecode"]
Instalar parecode MCP en Gemini CLI
$ gemini mcp add -s user parecode npx -- -y parecodeInstalar parecode MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblebasilskywalk/parecode is public and reachablegithub.com/basilskywalk/parecode ↗Aprobado
- El paquete indica este repositorio como su origenparecode names basilskywalk/parecode as sourcenpmjs.com/package/parecode ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for parecodenpmjs.com/package/parecode/v/0.7.0#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-14github.com/basilskywalk/parecode ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from parecodeAprobado
- No hay avisos críticos en el paquete ni en sus dependencias114 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubparecode
An MCP server that gives coding agents context-window-aware search and safe, atomic multi-file edits — built to cut token usage on large codebases without giving up correctness.
Requirements
- Node.js 20 or newer (ESM, native test runner, stable
fetch-free runtime). - ripgrep on
PATH(rgon Linux/macOS,rg.exeon Windows). Install via your package manager:- macOS:
brew install ripgrep - Debian/Ubuntu:
apt install ripgrep - Windows:
winget install BurntSushi.ripgrep.MSVCorchoco install ripgrep
- macOS:
- A supported MCP client (Claude Code is the reference target).
Parecode does not bundle ripgrep — it shells out to the system binary so you stay on a single, audited version.
Install
npm install -g parecode
Pure JavaScript — no native dependencies, no C/C++ toolchain required.
Quick start
Register the server with Claude Code:
parecode init # user scope; installs MCP + SessionStart hook + parecode-explore plugin (defaults)
parecode init --scope project # commit MCP config + hook to the repo
parecode init --no-hook # register MCP only; skip the SessionStart hook
parecode init --no-plugin # skip the parecode-explore Claude Code plugin
parecode init --print # print the equivalent command without running it
parecode init --remove-hook # remove the SessionStart hook (MCP stays registered)
parecode init --remove-plugin # uninstall the parecode-explore Claude Code plugin
The SessionStart hook injects a short directive at the start of each session telling Claude to prefer ParecodeSearch / ParecodeEdit over the equivalent native tools. Without it, Claude's first-party Grep / Read / Edit tools typically win by default and Parecode's token savings never land. The hook payload is a static string; parecode hook session-start prints it. Pass --no-hook if you would rather opt in explicitly per session via your own tooling.
The bundled parecode-explore Claude Code plugin adds a read-only subagent (pinned to Haiku, given only ParecodeSearch) and a matching skill, so exploration-style questions ("where is X?", "how does Y work?", "find all usages of Z") get answered in a cheap, isolated context window instead of burning tokens in your main session. init registers a local marketplace pointing at the npm-installed copy and runs claude plugin install parecode-explore@parecode. If your Claude Code build doesn't support the plugin subcommand the step soft-fails with a warning and the rest of init still succeeds; pass --no-plugin to skip it entirely, or --with-plugin to make any plugin-step failure hard-fail.
Then in any session, the ParecodeSearch, ParecodeExpand, and ParecodeEdit tools become available. Run parecode doctor to confirm registration, hook status, and .codegraph/ pairing if present.
What it does
ParecodeSearch— ripgrep-backed search that returns matches with surrounding context windows in a single call, with per-file byte chunking so large result sets do not blow up your context.patternaccepts a single string or an array of strings; arrays dispatch parallel ripgrep runs sharing the samepaths/contextLines, and each match carries apatterns: string[]field listing which input patterns contributed. One call replaces N back-to-back greps for related-keyword flow tracing.- Overlapping or adjacent windows within the same file are merged automatically (gap ≤
contextLines), with bridging lines loaded from disk. - Per-match and response-level
estimatedTokensare returned so the agent can self-budget before consuming results. - Opt-in
relatedSymbols: truesurfaces likely event-flow neighbours (Handle<X>,On<X>,<X>Handler/Listener/Closed/Completed/Started) discovered in each match, capped at 10. - Omitted line ranges are reported so the agent can widen with
ParecodeExpandwithout re-reading the whole file.
ParecodeExpand— widen a known(file, startLine, endLine)range with optionalcontextBefore/contextAfterpadding. Designed as the natural follow-up to aParecodeSearchmatch. Returns the sameestimatedTokensshape so the same self-budgeting heuristic applies. Prefer this over a full-fileReadafter locating a line.ParecodeEdit— batched multi-file edits with whitespace-tolerant fuzzy matching (and an opt-in Unicode-lookalike mode), pre/poststatconflict detection, and atomic same-directory rename writes. Cross-file edits run in parallel.parecode stats— local JSONL session log with token-saved estimates. Zero network. Zero telemetry.
Measured savings
On search-and-edit tasks — finding call sites, multi-file refactors, "do X to every Y" — Parecode cut cost ~40% and assistant turns ~75–83% in matched A/B tests:
| repo | task | cost | turns |
|---|---|---|---|
| TypeScript | find every call site of a symbol, edit each (17 sites, 8 files) | −43% | −83% |
| Unity / C# | find every call site of a symbol, edit each (11 sites, 5 files) | −41% | −76% |
Method: the identical task run with Parecode on vs off, a fresh session per run, n=3 per arm with alternated order, Sonnet 4.6. Savings come from collapsing many Grep / Read / Edit round-trips into single ParecodeSearch / ParecodeEdit calls — so the win scales with how much searching and multi-file fan-out a task involves, and shrinks toward zero on single-file or reasoning-heavy tasks. These are measured per-session token and cost numbers, not the estimates in the scan below.
Retroactive Savings Scan
Curious how much Parecode would have saved you if you had installed it earlier? You can scan your past Claude Code sessions:
parecode stats --retroactive --since 30d
Sample output:
Parecode — last 30d (retroactive scan)
─────────────────────
Sessions: 42
Tool calls: 156
Calls batched (est): 89
Tokens saved (est): 1,200,000
* Note: Retroactive savings are estimated, not measured.
Privacy disclaimer: This scan runs entirely locally against Claude Code's session transcripts (~/.claude/projects/**). By default, it parses only structured fields (tool names, paths, patterns, and token counts). It does not send any data over the network. The --include-content flag (which allows reading tool input/output) is strictly opt-in and loudly flagged if used.
Privacy
Parecode performs no network calls at runtime. Session logs are written to your OS data directory (resolved via env-paths) with 0600 permissions on Unix. Logs are self-maintaining: each server start prunes session data older than 30 days and caps the envelope log at 5 MB. Prune earlier with parecode prune <days> or wipe the data dir. Update to the latest release (and refresh hooks/plugin) with parecode update.
License
Preguntas sobre parecode MCP
¿Cómo agrego parecode MCP a Claude Code?
Ejecuta claude mcp add parecode -- npx -y parecode en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego parecode MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Viene ripgrep incluido en parecode?
No, utiliza el binario del sistema para que puedas usar tu propia versión auditada.
¿Cuánto puedo ahorrar en costos usando parecode?
En pruebas A/B comparativas, redujo los costos aproximadamente un 40% y las vueltas del asistente entre un 75–83% en tareas de búsqueda y edición.