Ripplet
Provides always-on agent rules and MCP access so GitHub Copilot can use Ripplet's local call/type/data graph for tasks such as finding callers, assessing change impact, previewing renames, and selecting relevant tests.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Coding agents break working code in places they never opened: a caller of a
function whose signature changed, a query on a column a migration dropped, an
import after a file move. Ripplet checks this with a local code graph, with no
LLM guessing, and gives the agent tools that make these edits in one call.
Every answer has file:line; a link the graph cannot prove is labelled, not guessed.
pip install "ripplet[treesitter-multilang]"
ripplet setup . # index + MCP config + agent rules, hooks and change guard, in one stepWhat it does
1. Guards the change. When the agent finishes, a hook runs check_change
and sends it back if it left something behind:
callers of a function whose signature changed
places still using what the edit replaced or removed
code using a table or column a migration dropped
frontend calls to an endpoint that changed
architecture rules broken (
ripplet.arch.yaml)the exact tests that reach the change
The same check reviews a PR (ripplet review, Markdown or SARIF for GitHub Code Scanning).
2. Makes the multi-file edits. Atomic, checked against the graph, and refused (nothing written) when it cannot prove the edit is safe:
rename_symbol: declaration, overrides, every call site and importchange_signature: add, remove or reorder parameters at every call sitemove_symbol: a function, class or type to another file or package, imports and namespaces fixed, in 14 languages (how each is checked)
3. Answers code questions with proof. Who calls this, what breaks if it changes, which files a task touches, which routes lack a permission check, which queries use a column. A precise graph of calls, types, routes and SQL, checked against compiler indexes: 0 wrong edges in 12 repositories.
Local. One SQLite file, no LLM, no cloud. Python 3.12+.
Related MCP server: Cordyceps Search
Results
Measured on real open-source repositories, same harness for every tool. Ripplet is compared with Graphify 0.9.92 (defaults).
Ripplet | Graphify | |
Callers found (call-site recall, 258 functions, 9 languages) | ~93% | ~23% |
Right file first for a task (hit@1, 389 real commits, 13 repos) | 63.0% | 44.5% |
Broken change caught by the selected tests (click, conduit) | 68-92% | 10-20% |
Wrong call edges vs a compiler (12 repos, 77,907 call sites) | 0 | not measured |
With a coding agent (Claude Haiku 4.5, headless, one run each, with vs without Ripplet):
Task | With | Without |
Rename a function everywhere, 13 repos in 13 languages (complete and compiles) | 13/13, $0.81, 85 turns | 12/13, $1.82, 420 turns |
Add a parameter, 4 repos (70 call sites) | $0.20, 15 turns | $1.42, 159 turns |
Move a function to a new module (requests, Python) | $0.09, 11 turns | $0.23, 28 turns |
Move a function to a new package (gin, Go) | $0.08, 10 turns | $0.23, 34 turns |
The gain is in changes. Exploring and building cost about the same with or
without Ripplet (five "add a feature" tasks: $1.00 vs $1.10, inside the noise).
Single runs: read them as a direction. Every move_symbol language was also
compiled or run on sampled symbols; across all of them none of the moves that were made broke the build (details).
Callers (site recall, share of real call sites found):
Set | Functions | Ripplet | Graphify |
fresh (13 repos: TS, Java, C#, Go, PHP, Python, Rust, Lua) | 150 | 93% | 23% |
dev (7 repos: Java, Lua, Python, TS, C#) | 67 | 96% | 29% |
extra (9 repos: Lua, Ruby, Rust) | 41 | 89% | 16% |
Java 99% vs 66%, TypeScript 91% vs 14%, Python 96% vs 29%, Go 98% vs 48%, C# 93% vs 11%, Lua 94% vs 6%, Rust 90% vs 56%, Ruby 86% vs 25%, PHP 100% vs 79%.
Where a task should be done (task_context vs graphify query; the commit subject is the task, the files it changed are the answer; hit@5 83.8% vs 69.9%):
Repository | Tasks | hit@1 Ripplet | hit@1 Graphify |
httpx (Python) | 38 | 53% | 34% |
marshmallow (Python) | 29 | 76% | 41% |
jsoup (Java) | 40 | 60% | 30% |
chi (Go) | 40 | 62% | 50% |
attrs (Python) | 15 | 80% | 33% |
zustand (TypeScript) | 11 | 91% | 91% |
gson (Java) | 39 | 46% | 36% |
cobra (Go) | 40 | 82% | 52% |
monolog (PHP) | 40 | 68% | 55% |
javapoet (Java) | 37 | 70% | 70% |
commons-text (Java) | 18 | 78% | 72% |
commons-csv (Java) | 7 | 71% | 14% |
JsonPath (Java) | 35 | 26% | 11% |
Test selection (mutants caught by the selected tests, Ripplet / Graphify / grep): click 68% / 10% / 30%, conduit 92% / 20% / 52%. Ripplet selects more tests (43% of click's suite, 16% of conduit's).
Precision against SCIP compiler indexes (recall, wrong edges): hono 0.955, h3 0.986, axios 1.000,
starlette 0.964, requests 0.974, ripgrep 0.938, axum 0.852, eShopOnWeb 0.920, gin 0.959, echo 0.940,
spring-petclinic 0.962, commons-lang 0.905. All 12: 0.925 of 77,907 call sites, 0 wrong edges.
A call Ripplet cannot prove (an untyped receiver whose method name exists in the project) is not
turned into an edge; agents see it in an UNVERIFIED section.
Use it
ripplet setup . # init, index, .mcp.json / opencode.json, rules, skill, hooks, guard
ripplet check . --run-tests # broken callers + the tests that reach the change
ripplet review . --base origin/main # PR review (Markdown or --format sarif)
ripplet arch # architecture rules in ripplet.arch.yaml
ripplet ui . # browse the graphGitHub Action. Reviews every pull request with proof and no LLM: findings appear
as one sticky comment (also in the job summary, for forks), and on the diff as annotations with sarif: true.
# .github/workflows/ripplet.yml
on: pull_request
permissions: { contents: read, pull-requests: write }
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with: { fetch-depth: 0 }
- uses: sh4-p/ripplet@v1
# with: { fail-on: error } # error | warning | note | never
# with: { sarif: true } # annotations on the diff; needs Code Scanning + security-events: writeAgent | Always-on guidance | Enforcement |
Claude Code |
| PreToolUse / PostToolUse hooks, Stop-hook change guard |
OpenCode |
| plugin, change guard |
Gemini CLI |
| BeforeTool hook |
Codex, Hermes, Amp, Devin, Jules |
| |
Cursor, GitHub Copilot, Kiro, Windsurf, Antigravity, Cline | their rules files |
ripplet rules on . --strict blocks the first raw read/grep until a Ripplet tool is
used; --prefetch adds the task's context to each Claude Code request before the
agent starts (off by default: it did not change cost).
Architecture rules are checked on the graph, not on text:
rules:
- id: writes-need-permission
must_call: [requireRole, requireNotViewer]
for: {path: "app/Controllers/*.php", type: [method], public: true, name: "^(store|update|delete)"}
depth: 3
- id: ui-not-db
forbid: {from: "src/ui/**", to: "src/db/**"}MCP tools
ripplet mcp serves these over stdio (ripplet tool <name> key=value runs any from the shell):
Tool | Use it for |
| after editing: broken callers, leftovers, schema and endpoint gaps, the exact tests to run |
| multi-site edits in one call ( |
| before a rename, signature change or removal: every line to touch, same-named code to leave alone |
| the start of a task: the code it is about, callers, routes / tables, the feature to imitate, files to edit, tests |
| source, callers and callees with |
| a stack trace mapped to functions, code and callers |
| routes, handlers and the permission checks they make |
| the rest |
Answers fit a token budget and say how to get more. A name not in the index returns "not found" with the closest names, never an empty list that reads as "no callers".
Languages
Language | Graph |
|
Python | AST; imports, | yes |
TypeScript / JavaScript | namespaces, re-export barrels, workspaces, callbacks | yes |
Java, Kotlin | packages, overloads, extension functions, generic supertypes | yes |
C#, Go, Rust, PHP, Dart | namespaces / packages / modules, traits and interfaces, Laravel container | yes |
Ruby, Lua, GDScript | modules, mixins, Rails conventions, requires | yes |
Swift | modules, extensions, closures | yes (same module) |
C / C++ | includes, templates, | yes |
Also indexed: SQL schemas and migrations (Laravel, Rails, Django, Alembic, EF Core, Prisma), HTTP routes and the client calls that hit them, Docker Compose, Kubernetes, CI workflows, Terraform, Markdown docs, config files.
The UI
ripplet ui . opens a local, read-only explorer: module map, a symbol's
neighbourhood, impact ring by ring with the tests that reach it, your working-tree
changes, paths between symbols, routes, tables and their queries, index health,
and a dry-run rename preview.
Install
pip install ripplet # Python, Markdown, config, SQL
pip install "ripplet[treesitter-multilang]" # + every language above
pip install "ripplet[watch]" # ripplet watch: re-index on saveLimitations
Static analysis: reflection, string-built names and runtime-configured DI are not followed (Laravel's
app(X::class)is).Dynamic languages (Ruby, Lua, untyped PHP) have more UNVERIFIED sites; Ripplet reports them.
Generated code that exists only after a build is not indexed.
Folders your
.gitignoreexcludes (oftentests/) are not indexed;check_changesays so.move_symbolhas per-language limits (Swift: one module; C/C++: header/source rules, new file added to the build by hand): see docs/move_symbol.md.
License
Source-available under the Functional Source License 1.1, Apache 2.0 future license (FSL-1.1-ALv2).
Free to use for anything except a competing product: personal, work, commercial, CI, education, research.
Free to change, and to share your changes, as long as the license and copyright notices stay.
Not allowed: offering Ripplet or a fork as a competing commercial product or service.
Becomes Apache 2.0 two years after each release.
The name "Ripplet" and its logo are trademarks and are not licensed.
For a commercial or team license, contact the author.
Support
Ripplet is built by one person. If it saved you a few greps (or a broken release), you can buy me a coffee.
Mehmet Emin Madanoglu
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Ask a codebase what calls what: search, blast radius, paths between symbols, and diffs.
Ask who calls a route, what a change breaks or who reads a field, across a system's repos.
Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.19 PyPI4MIT
- FlicenseNot gradedqualityBmaintenanceEnables developer agents to perform semantic codebase search, dependency and impact analysis, cross-file refactoring, and full-stack API tracing through a unified query DSL over a high-performance graph engine.-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and terminal users to query codebases for callers, impact, tests, dependencies, and refactor previews using static AST analysis, with every match accounted for and uncertain relationships clearly marked.1,067 npm2MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI coding agents to query a local structural code graph, inspect relationships and impact, and retrieve focused project context before reading full files.24 npmMIT