repolex

library0.11.1jsnpmunverified

Repolex (v0.11.1) builds a local SQLite FTS5 index of your codebase for fast grep-like lookups and AI-synthesized architecture summaries, exposed to Claude Code via the Model Context Protocol (MCP). It indexes symbol definitions (classes, functions, methods) with line numbers across Ruby, TypeScript, JavaScript, Python, and 10+ other languages. Its key differentiators are per-row staleness flags (the model knows when synth data is stale), optional AI synthesis (architecture/domains/endpoints/db_tables) via Anthropic API with configurable cost limits, incremental refresh, and a portable SQLite file that can be committed to a private repo for team sharing. Runs entirely locally unless API mode is enabled.

devops ai-ml

npm install repolex

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REPOLEX

repolex

devopsjavascriptv0.11.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

repolex (CLI)

✓ npx repolex <command>

✗ npm install repolex && repolex run

Should be installed globally or used via npx. No run subcommand.

MCP tools (Claude Code)

✓ Claude Code automatically discovers tools via MCP config in ~/.claude.json after running 'repolex setup --register-clients'

✗ Manual tool registration or require('repolex').tools

Tools are exposed via MCP protocol, not as a Node.js library.

setup --register-clients

✓ repolex setup --register-clients

✗ repolex init --register-clients or repolex setup --install-clients

'--register-clients' is the correct flag, not '--install-clients'. It writes the MCP config to ~/.claude.json.

Global install, setup with Claude Code, index a project, and optionally run AI synthesis.

#!/usr/bin/env bash # Global install npm install -g repolex # Setup and register with Claude Code repolex setup --register-clients # Index your project (from repo root) repolex index myapp --path . # Restart Claude Code, then ask: # "Where does billing logic live?" # "What endpoints does the UsersController have?" # "Find all references to the authenticate! method" # Optional: AI-synthesized architecture summaries # Set up ANTHROPIC_API_KEY environment variable first export ANTHROPIC_API_KEY='sk-...' repolex synthesize myapp --max-cost 10 # Run doctor to verify environment repolex doctor

Debug

Known issues

breakingNode.js >=20 is required. Older versions will fail to install or run.

fix

Upgrade Node.js to version 20 or later.

affects: <20

gotcharepolex index requires repomix to be installed globally (npm install -g repomix). If missing, indexing will silently fail or produce an empty database.

fix

Install repomix: npm install -g repomix

affects: >=0.1.0

gotchaThe synthesize command sends code to Anthropic API unless running in purely local mode. Without '--mode anthropic-api' or 'hybrid', code never leaves the machine, but default mode may be local-only? Check documentation for mode defaults.

fix

Set ANTHROPIC_API_KEY for synthesis; review mode flags in docs.

affects: >=0.1.0

gotchaAfter running repolex setup --register-clients, you must restart Claude Code for the new MCP server to be detected.

fix

Quit and restart Claude Code (or reload MCP config if supported).

affects: >=0.1.0

gotchaPython symbol extraction is partial: only top-level classes and defs are indexed. No nested symbols or fully qualified names (FQNs) are available.

fix

Use search_code or find_references for Python files instead of relying on symbol table.

affects: >=0.1.0

gotchaLanguages like Go, Java, Kotlin, C#, PHP, Swift, Rust, Scala, Erlang, and Elixir are indexed and searchable, but symbol tables are empty (no symbol extraction).

fix

Use search_code and find_references for those languages; symbol-specific tools will return no results.

affects: >=0.1.0

Errors

Common errors & fixes

Error: repomix is not installed. Please install repomix globally.

repolex requires repomix for file snapshotting, but it's not installed or not in PATH.

fix

npm install -g repomix

Error: Cannot find module '...//repolex/build/index.js'

Global installation may have failed or path resolution issue.

fix

Reinstall globally: npm install -g repolex

No MCP tools visible in Claude Code after setup

Claude Code was not restarted after repolex setup, or MCP config file (~/.claude.json) is missing/incorrect.

fix

Restart Claude Code completely. If still missing, run 'repolex doctor' to diagnose.

repo:directory is not a git repository

The targeted path is not inside a git repository or git is not installed.

fix

Initialize git in the target directory: git init, or ensure you are in a valid git repo.

ANTHROPIC_API_KEY is not set

Trying to run 'repolex synthesize' without setting the environment variable.

fix

export ANTHROPIC_API_KEY='sk-your-api-key-here' before running synthesize.

Upgrade

Version history

0.11.1latest on npm

Audit

Dependencies

repomixrequiredRequired for snapshotting the source code before indexing

gitrequiredRequired for repository operations and change tracking

syftoptionalOptional SBOM detection for enhanced techstack analysis

Agent activity

8 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/crisnahine/repolex ↗

packagerepolex ↗

homepagehttps://github.com/crisnahine/repolex ↗