Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (parecode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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.

Status: pre-M0. The package name is reserved; the implementation is in active development.

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

parecode init                       # user scope by default
parecode init --scope project       # commit MCP config to the repo
parecode init --with-hook           # also install a SessionStart hook that nudges Claude to prefer Parecode tools
parecode init --print               # print the equivalent command without running it
parecode init --remove-hook         # remove the SessionStart hook

Then in any session, the ParecodeSearch and ParecodeEdit tools become available. Run parecode doctor to confirm registration and hook status.

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. Omitted line ranges are reported so the agent can request a specific window without re-reading the whole file.
ParecodeEdit — 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. Cross-file edits run in parallel.
parecode stats — local JSONL session log with token-saved estimates. Zero network. Zero telemetry.

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. Prune with parecode prune <days> or wipe the data dir.

License

MIT