✦ CLI Rust · Serveur MCP · Cross-platform

L'index local
de ta codebase pour les agents IA.

RepoLens scanne ton repo, construit des index compacts et expose des outils de navigation via CLI et serveur MCP stdio — sans infrastructure externe.

Installer → Voir comment ça marche
repolens — zsh
$ repolens index .
# Indexing... 20 files, 136 symbols

$ repolens status .
files: 20   words: 1153   trigrams: 8889
symbols: 136   deps_files: 14

$ repolens symbol ProjectIndex .
src/indexer.rs:42   struct ProjectIndex

$ repolens mcp .
# MCP server listening on stdio…
⚡ Rust natif ⚡ MCP stdio server ⚡ tree-sitter symbols ⚡ rg-like filtering ⚡ Windows · Linux · macOS ⚡ index trigram + word ⚡ Rust, TS, JS, Python ⚡ Zero infra externe ⚡ CI multi-plateforme ⚡ Open Source ⚡ Rust natif ⚡ MCP stdio server ⚡ tree-sitter symbols ⚡ rg-like filtering ⚡ Windows · Linux · macOS ⚡ index trigram + word ⚡ Rust, TS, JS, Python ⚡ Zero infra externe ⚡ CI multi-plateforme ⚡ Open Source
// Comment ça marche

Trois étapes. C'est tout.

RepoLens scanne ta codebase, extrait les symboles avec tree-sitter, et expose tout via CLI ou MCP.

01

Lance l'indexation

RepoLens scanne ton repo avec un filtrage proche de rg: ignore Git, fichiers cachés, dossiers de build, et chemins sensibles par défaut.

$ repolens index .
02

Explore ta codebase

Recherche par mots, trigrammes ou symboles. Lis des fichiers avec plage de lignes. Liste les dépendances.

$ repolens search "handleAuth" .
03

Connecte tes agents IA

Lance le serveur MCP stdio. Sans dossier en argument, ton agent choisit ensuite le projet avec workspaceRoot.

$ repolens mcp
// Fonctionnalités

Tout ce qu'il te faut, rien de plus.

🔍

Recherche ultra-rapide

Index de mots et trigrammes pour des recherches instantanées dans tout le repo.

🌳

Extraction de symboles

Rust, TypeScript, JavaScript, TSX/JSX, Python — powered by tree-sitter.

🤖

Serveur MCP stdio

13 outils MCP exposés. Compatible Claude, Cursor, Codex et tout agent MCP.

🛡️

Sécurité par défaut

.env, clés PEM, secrets — ignorés automatiquement. Configurable via .repolensrc.toml.

🖥️

Cross-platform

Windows, Linux, macOS (x86_64 + arm64). CI automatique sur les trois plateformes.

📦

Import / dépendances

Extraction des imports pour Rust (use, mod), TS/JS (import, require) et Python.

📉

Économie de contexte

Lecture compact/aggressive, résumés JSON smart et stats gain pour estimer les tokens économisés.

🧪

Tests-aware

Rapport JSON générique sur frameworks de test, fixtures, mocks, assertions et lignes importantes.

// Commandes CLI

Tout en ligne de commande.

index Construit .repolens/index.json repolens index .
search Recherche dans le contenu indexé repolens search "handleAuth" .
symbol Trouve les symboles par nom repolens symbol MyStruct .
outline Liste les symboles d'un fichier repolens outline src/main.rs .
deps Liste les imports d'un fichier repolens deps src/main.rs .
read Lit un fichier avec plage de lignes ou niveau compact repolens read src/lib.rs . --level aggressive
smart Résumé JSON mécanique d'un fichier repolens smart src/main.rs .
tests-aware Rapport JSON sur les tests du dépôt repolens tests-aware .
gain Stats locales de tokens économisés repolens gain . --format json
self-update Met à jour le binaire installé repolens self-update
status Affiche les compteurs de l'index repolens status .
mcp Démarre le serveur MCP stdio repolens mcp .
// Serveur MCP

Branché sur tes agents IA.

RepoLens expose 13 outils MCP via stdio. Connecte Claude, Cursor, Codex ou n'importe quel agent compatible MCP directement à ton index local.

repolens_status repolens_tree repolens_search repolens_word repolens_read repolens_outline repolens_symbol repolens_deps repolens_rdeps repolens_edit repolens_changes repolens_snapshot repolens_bundle

Workflow agent: commence par repolens_status, confirme que root pointe vers le repo courant, puis utilise search, word, symbol, outline, deps, rdeps et read avant les recherches shell larges.

Pour chaque nouveau projet: repolens index . construit l'index local; repolens init . --target codex enregistre ce root dans Codex. Un transport RepoLens actif recharge cette liste sans redemarrage; redemarre Codex seulement si les outils repolens_* ne sont pas encore charges.

mcp — json-rpc
// Appel bundle multi-outils

{"jsonrpc":"2.0",
 "method":"tools/call",
 "params": {
  "name":"repolens_bundle",
  "arguments": {
   "ops": [
    {"tool":"repolens_status"},
    {"tool":"repolens_search",
     "arguments":{"query":"main"}}
   ]
  }
 }}
// Installation

Prêt en quelques minutes.

Installe RepoLens une fois, puis active-le dans les projets où tu veux l'utiliser.

iwr https://raw.githubusercontent.com/dandyArise/RepoLens/main/install/install.ps1 -UseBasicParsing | iex
cd my-project
repolens index .
repolens init . --target codex
repolens mcp-status --target codex

Apres init, commence par repolens_status pour confirmer le root. Si RepoLens est deja charge, la nouvelle racine est disponible sans redemarrage; sinon redemarre le client une fois puis verifie /mcp.

git clone https://github.com/dandyArise/RepoLens.git
cd RepoLens
cargo build --release
./target/release/repolens --help
// Roadmap

Ce qui est fait, ce qui vient.

✅ Implémenté

CLI Rust cross-platform
Scanner avec filtrage proche de rg
Index word + trigram
Extraction de symboles (tree-sitter)
Serveur MCP stdio (13 outils)
CI Windows / Linux / macOS
Snapshot JSON (.repolens/index.json)
Scripts d'installation (PowerShell / shell)
Serveur HTTP localhost + UI
Commande d'édition atomique
Watcher + réindexation incrémentale
MCP auto-config Claude / Cursor / Codex
Read compact/aggressive + smart + gain
Tests-aware générique
Commande self-update

🔜 En cours / Prévu

Rapport perf pour gros dépôts
Auto-config MCP plus robuste