rp-mini
rp-mini is a minimal context-engineering MCP server for coding agents. It keeps RepoPrompt's core context workflow — fast search, codemaps, curated selections, packaged exports, and safe edits — without requiring a GUI app. It is designed for one stdio server process per agent session so concurrent agents do not serialize through one shared app process.
Install
Claude Code
- Build the workspace:
pnpm install && pnpm build && pnpm build:prompts
- Install the local plugin:
claude plugin install ./packages/cc-plugin
- Marketplace distribution: TBD.
The Claude plugin lives at packages/cc-plugin and includes .mcp.json, a generated context-builder agent, rp-* skills, and a SessionStart warm hook.
Codex
- Build the workspace:
pnpm install && pnpm build && pnpm build:prompts
- Install skills and print the MCP config snippet:
packages/codex-plugin/install.sh
- To append the MCP snippet to
~/.codex/config.toml, rerun with --write-config.
The Codex plugin lives at packages/codex-plugin; uninstall with packages/codex-plugin/install.sh --uninstall.
Shell CLI
The server package also exposes a direct shell CLI for use without a loaded Codex, Claude, or MCP client:
node packages/server/dist/cli.js --help
node packages/server/dist/cli.js index /path/to/workspace
node packages/server/dist/cli.js search /path/to/workspace ContextBuilder --max-results 20
node packages/server/dist/cli.js read /path/to/workspace Sources/App.ts --start-line 40 --limit 80
node packages/server/dist/cli.js tree /path/to/workspace --mode folders --max-depth 3
node packages/server/dist/cli.js structure /path/to/workspace Sources/App.ts
node packages/server/dist/cli.js serve --profile explorer --root /path/to/workspace
Common wrappers cover search, read, tree, structure, selection, prompt/context packaging, git, edits, file actions, token counting, and indexing. Any MCP tool can also be invoked directly:
node packages/server/dist/cli.js tool /path/to/workspace file_search --json-args '{"pattern":"ContextBuilder","max_results":10}'
node packages/server/dist/cli.js tool /path/to/workspace apply_edits --profile explorer --json-args '{"path":"src/a.ts","search":"old","replace":"new","dry_run":true}'
Configuration
Config layers are defaults, ~/.config/rp-mini/config.json, workspace rp-mini.config.json, environment variables, then host overrides.
| Key | Default | Effect |
|---|
roots | ["."] | Workspace roots served by the MCP process. |
profile | full | Role profile: full, editor, or explorer. |
tokenizer | heuristic | Token estimator used for budgets and context receipts. |
budgets.discovery | 160000 | Default discovery/export budget. |
budgets.plan | 120000 | Planning preset budget. |
caps.search_chars | 50000 | Response character budget for search shaping. |
caps.structure_tokens | 6000 | Codemap response token cap. |
caps.tree_tokens | 10000 | Default adaptive file tree token cap; auto mode degrades from full tree toward summarized/selected views while preserving anchors. |
caps.git_patch_lines | 300 | Git patch lines included in review exports. |
caps.file_size_bytes | 10000000 | Oversized-file threshold for catalog/search safety. |
codemaps.languages | ts, tsx, js, py, swift, go, rust, java, c, cpp, c_sharp, ruby, php, dart | Languages eligible for codemap extraction. |
codemaps.cache_dir | .rp-mini/codemap-cache | Shared atomic codemap cache location under the root. |
ignore.extra | [] | Additional ignore globs. |
ignore.ios_preset | auto | Applies iOS/Xcode ignore behavior when relevant. |
search.ripgrep_path | unset | Optional explicit rg binary path. |
dynamic_roots.enabled | true | Allows each MCP call to target an absolute alternative workspace root. |
dynamic_roots.max | 4 | Maximum number of dynamic root contexts cached per server process. |
tools.apply_edits | true | Enables the edit tool. |
tools.file_actions | true | Enables create/delete/move tool. |
tools.git | true | Enables read-only git tool. |
selection.auto_codemaps | true | Adds codemap-only dependencies for selected files. |
selection.persist | true | Persists per-session selections in .rp-mini/sessions. |
selection.scope | session | Selection storage scope; workspace uses shared state. |
context_builder.enhancement | rewrite | Prompt enhancement mode for context-builder skills. |
context_builder.intent_detection | true | Enables preset inference from user instructions. |
presets | standard, plan, review, diff-followup, mvp | Controls export sections, trees, codemaps, git diff, and meta prompts. |
packager.section_order | file_map, file_contents, git_diff, meta_prompts, user_instructions | XML export section order. |
