코딩 에이전트가 토큰을 고려한 ripgrep 검색과 원자적 다중 파일 편집을 수행하여 컨텍스트 창 사용량을 줄일 수 있도록 지원합니다.
다른 이름 BasilSkyWalk/parecode
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.7.0
- 마지막 커밋
- 2026년 9월 14일
- 라이선스
- MIT
parecode MCP란?
parecode은(는) MCP server입니다. 코딩 에이전트가 토큰을 고려한 ripgrep 검색과 원자적 다중 파일 편집을 수행하여 컨텍스트 창 사용량을 줄일 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
parecode MCP server 정보
컨텍스트 창을 소진하지 않으면서 대규모 코드베이스를 탐색해야 하는 코딩 에이전트는 parecode를 사용하여 토큰을 고려한 검색과 다중 파일 편집을 수행할 수 있습니다. 이 서버는 시스템에 설치된 ripgrep을 활용하여 ParecodeSearch 및 ParecodeEdit와 같은 도구를 제공하며, 기존의 여러 도구 호출을 하나의 효율적인 작업으로 통합합니다. 이러한 방식은 토큰 소비량과 복잡한 리팩터링 작업을 완료하는 데 필요한 턴 수를 모두 줄이도록 설계되었습니다.
Claude Code를 사용하는 개발자는 npm을 통해 로컬에 서버를 설정할 수 있습니다. 설치 과정에는 이러한 특화된 도구에 우선순위를 두는 선택적 SessionStart hook과 탐색형 질문에 저비용 subagent를 사용하는 parecode-explore 플러그인이 포함됩니다. 시스템은 네트워크 호출이나 텔레메트리 없이 로컬 머신에서 완전히 작동하므로 코드 데이터와 세션 로그의 프라이버시가 보장됩니다. 사용자는 절약된 토큰을 추정하는 로컬 세션 로그를 통해 효율성을 모니터링할 수 있습니다.
활용 사례
- 1효율적인 다중 파일 리팩터링에이전트가 여러 파일에 걸쳐 특정 심볼의 모든 호출 지점을 찾아 단일 배치 작업으로 모든 변경 사항을 적용할 수 있습니다.
- 2컨텍스트 인식 코드 탐색개발자가 특정 컴포넌트의 위치나 함수의 작동 방식을 물을 때 저비용 subagent를 사용하여 메인 세션 토큰을 절약할 수 있습니다.
- 3타겟팅된 코드 검색별도의 grep 명령을 실행하지 않고도 여러 관련 패턴을 동시에 검색하여 이벤트 흐름을 추적할 수 있습니다.
- 4검색 결과 확장관심 있는 특정 라인을 찾은 후, 파일 전체를 다시 읽지 않고도 에이전트가 가시적인 코드 범위를 넓힐 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
parecode MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 parecode MCP 설치
$ claude mcp add parecode -- npx -y parecodeCursor에 parecode MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}VS Code에 parecode MCP 설치
.vscode/mcp.json
{
"servers": {
"parecode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}VS Code CLI에 parecode MCP 설치
$ code --add-mcp '{"name":"parecode","type":"stdio","command":"npx","args":["-y","parecode"]}'Claude Desktop에 parecode MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Codex에 parecode MCP 설치
$ codex mcp add parecode -- npx -y parecodeCodex config.toml에 parecode MCP 설치
~/.codex/config.toml
[mcp_servers.parecode] command = "npx" args = ["-y", "parecode"]
Gemini CLI에 parecode MCP 설치
$ gemini mcp add -s user parecode npx -- -y parecodeGemini settings.json에 parecode MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능basilskywalk/parecode is public and reachablegithub.com/basilskywalk/parecode ↗통과
- 패키지가 이 저장소를 소스로 명시parecode names basilskywalk/parecode as sourcenpmjs.com/package/parecode ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for parecodenpmjs.com/package/parecode/v/0.7.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-14github.com/basilskywalk/parecode ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from parecode통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음114 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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.
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
parecode MCP 질문
parecode MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add parecode -- npx -y parecode를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
parecode MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
parecode에 ripgrep이 포함되어 있나요?
아니요, 시스템 바이너리를 호출하여 사용하므로 사용자가 직접 검증한 버전을 사용하게 됩니다.
parecode를 사용하면 비용을 얼마나 절감할 수 있나요?
A/B 테스트 결과, 검색 및 편집 작업에서 비용은 약 40%, 어시스턴트 턴 수는 75–83% 절감되었습니다.