v1.0 · zero Docker by default

Your codebase,
as a graph you and your agents
can actually query.

RIP parses any repository into a knowledge graph with Tree-sitter. Works offline and no Docker required — Neo4j, Qdrant are optional for team/server use.

6 languages parsed MCP native local-first · zero cloud MIT licensed
SCROLL

Three steps from zero → zero Docker.

1

Install RIP

Install via pip in one command:

pip install repo-intelligence==0.1.0
python 3.11+ required
2

Init your repo

Open a terminal, cd to your repository, and run repo init .

no config · no setup
3

Index & Ask

repo index . then start tracing functions! That's it!

local-first by default
LOCAL

Local Mode

No Docker, no servers, or network required. Works 100% offline.

AUTO

Auto Mode

Probes for Neo4j/Qdrant/Postgres; uses server providers if available.

SERVER

Server Mode

Use all features: REST API, Flutter, Context Gateway, shared indexes.

Not a chatbot wrapper.
An understanding engine.

Every query is answered from a real graph traversal or vector search — not an LLM guessing at file contents. The model only narrates what the graph already proved.

Knowledge Graph

Every file, class, function and widget becomes a node. Calls, imports, and inheritance become typed edges in Neo4j.

trace · impact · dependencies

Semantic Search

Qdrant vector search finds code by what it does, not what it's named. Hybrid-ranked against the graph for precision.

vector + lexical + graph rerank

Agent-Native

Ships as an MCP server. Claude Code, Cursor, and Codex call rip_trace instead of reading files blind.

MCP stdio · Context Gateway

Impact Analysis

Before you touch a symbol, know exactly what breaks. Risk-scored, graph-traversed, no guessing.

blast-radius before you commit

Six Languages

Python, TypeScript, Java, Go, Rust, and Dart/Flutter — same graph schema, same query surface, every repo.

tree-sitter parsed

Local-First

Neo4j, Qdrant and Postgres on your machine or your server. Your code never has to leave the network.

docker compose up

Clone, isolate, index, ask.

Remote Git indexing works from terminal and the Flutter APK. Clone any repo into a named folder, then index only the subfolder you care about.

remote git indexing - rip

Clone a repo, index only the folder that matters.

RIP can now clone a GitHub repository from the CLI or Flutter APK, initialize the selected project folder, respect .gitignore, and keep that project isolated from every other indexed repo.

CLI

Use an explicit clone folder and a subfolder target. For Flutter apps, indexing lib keeps the graph focused on application code instead of Android, iOS, and build scaffolding.

repo git-index https://github.com/pratiksingh1702/flutter_music_app.git --folder-name flutter_music_app_lib --project-name flutter_music_app_lib --subdir lib --branch main

Flutter APK

The mobile app exposes the same flow through chat and the Add Repository sheet: Git URL, clone folder, index subfolder, project name, and branch all map to the same backend job.

/index https://github.com/pratiksingh1702/flutter_music_app.git --folder flutter_music_app_lib --project-name flutter_music_app_lib --subdir lib --branch main
WORKING

Windows-safe cloning

Remote clone jobs run Git in a worker thread, avoiding Windows event-loop subprocess failures under Uvicorn reload.

ISOLATED

Stable project roots

The clone folder stores the repository, while the indexed root can be a subfolder such as lib. Project IDs are derived from that indexed path.

CLEAN

.gitignore respected

Git-backed discovery uses tracked plus untracked non-ignored files, so ignored build output does not enter the graph.

VISIBLE

Live job progress

WebSocket and polling status report clone path, index path, subfolder, files indexed, entities found, and actionable failures.

Built for repos that have outgrown grep.

0×
token reduction vs. raw file context
0
languages parsed with Tree-sitter
0
entities indexed in <60s on a real repo
0
interfaces: CLI · API · MCP · mobile
01

Parse

Tree-sitter builds an exact AST per file. No regex guessing.

02

Graph

Entities and relationships land in Neo4j as typed nodes and edges.

03

Embed

Code chunks are vectorized into Qdrant for semantic recall.

04

Query

CLI, REST, MCP, or mobile — same graph, same answers.

Built in the open.
Maintained by whoever shows up.

RIP is MIT-licensed and has no roadmap decided behind closed doors. Every graph query, every parser, every line of the Context Gateway is there for you to read, fork, or improve.

Add a language parser

Tree-sitter grammars exist for 100+ languages. The parser interface is small and documented — C#, Kotlin, and Ruby are open.

good first PR · core/parser/

Improve the ranker

The Context Gateway's scoring weights are hand-tuned, not learned. If you have ideas on better relevance signals, this is the highest-leverage area.

help wanted · gateway/core/ranker/

Test it on your repo

Real-world repos surface real-world bugs. Index something messy and file what broke — that's the most valuable signal we get.

report issues · no code required

Write docs & examples

Most of the codebase has no written walkthrough beyond inline comments. If you read code to understand it, that's a doc gap to fix.

docs/ · no setup needed

Build a client

The REST API and MCP server are stable interfaces. A web dashboard, a JetBrains plugin, an Obsidian integration — bring your own frontend.

server/ · mcp/ · stable contracts

Run benchmarks

No published numbers exist yet comparing RIP against grep, plain RAG, or other code-intelligence tools. First measured benchmark gets credited.

scripts/benchmark.sh
01

Fork & clone

Standard GitHub fork workflow. uv sync and you're running locally in minutes.

02

Pick an issue

Labelled good first issue or help wanted if you want a starting point.

03

Open a PR

Small, focused changes merge fast. Tests and a one-line rationale go a long way.

Three ways to talk to the project

No Discord yet — issues and discussions live on GitHub where the code already is.

Index your first repo in under a minute.

Open source. Self-hosted. No telemetry leaving your machine.