basilskywalk avatar

Parecode

basilskywalk/parecode

Ripgrep-backed code search and multi-file editing designed to keep coding agents under budget. Exposes ParecodeSearch with per-match token estimates and automatic context window merging, ParecodeExpand for widening ranges without full file reads, and ParecodeEdit for atomic batched writes with fuzzy matching. The init command wires up a SessionStart hook that nudges Claude toward these tools over native Grep/Read/Edit, plus an optional Haiku-powered subagent for exploration queries. Best on search-heavy tasks like refactors or call-site edits where you'd otherwise burn tokens on repeated grep-read-edit loops. Measured A/B tests show 40% cost cuts and 75% fewer turns on multi-file symbol rewrites. Local JSONL logs track savings with a retroactive scan mode for past sessions.

GitHub stars
5
tools
3
transport
STDIO
last updated
Jun 10, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

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

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.

No parameter schema in public metadata yet.

ParecodeExpandWiden a known (file, startLine, endLine) range with optional contextBefore / contextAfter padding.

Widen a known (file, startLine, endLine) range with optional contextBefore / contextAfter padding.

No parameter schema in public metadata yet.

ParecodeEditBatched multi-file edits with whitespace-tolerant fuzzy matching (and an opt-in Unicode-lookalike mode), pre/post stat conflict detection, and atomic same-directory rename writes.

Batched multi-file edits with whitespace-tolerant fuzzy matching (and an opt-in Unicode-lookalike mode), pre/post stat conflict detection, and atomic same-directory rename writes.

No parameter schema in public metadata yet.

Sponsors

Readme

parecode

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.

parecode MCP server


Requirements

  • Node.js 20 or newer (ESM, native test runner, stable fetch-free runtime).
  • ripgrep on PATH (rg on Linux/macOS, rg.exe on Windows). Install via your package manager:
    • macOS: brew install ripgrep
    • Debian/Ubuntu: apt install ripgrep
    • Windows: winget install BurntSushi.ripgrep.MSVC or choco install ripgrep
  • 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:


View the full README on GitHub

Details

Repository
github.com/basilskywalk/parecode
Category
Search & Web Crawling
Package
parecode
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1unlikefraction avatarSilicon Friendlyunlikefraction/silicon-friendlyDirectory rating websites on AI-agent-friendliness. Search, lookup, and submit.5stars
2cotletdev avatarOmio MCP Server and API by Cotletcotletdev/omio-api-mcp-serverOmio travel transport booking MCP server: search trips, find the cheapest day, start booking.0stars
3domdomegg avatarGoogle Contactsdomdomegg/google-contacts-mcpAllow AI systems to list, search, and manage contacts via Google Contacts.5stars
4kiki830621 avatarChe Apple Mail Mcpkiki830621/che-apple-mail-mcpApple Mail MCP — 44 tools, SQLite millisecond search, .emlx parser, batch ops5stars
5pineapple-farm avatarSkill Historypineapple-farm/skill-historyTrack download history for 70,000+ agent skills. Search and get daily snapshots.5stars
6tigergraph avatarTigerGraphtigergraph/tigergraph-mcpExplore and evolve TigerGraph schemas, run GSQL and Cypher, load data, and search vector embeddings.5stars