repomind-cli 1.0.0

Give Claude Code a brain for your entire codebase. Index once, ask anything.

🧠 RepoMind

Give Claude Code a brain for your entire codebase.

Index once. Ask anything. Never explain your code to AI again.

---

The Problem

You open Claude Code, paste half your codebase into the chat, and still get hallucinated function names.

You're not giving AI a codebase — you're giving it a dump. AI needs understanding, not just text.

The Solution

RepoMind builds a semantic brain for your repo. Every file, chunked and embedded locally. Ask it anything — it finds exactly what's relevant and feeds that to the AI.

repomind index .
repomind ask "How does authentication work?"

That's it.

---

⚡ Quickstart

pip install repomind-cli

cd your-project/
repomind index .
repomind ask "Where is the payment logic?"

No API key needed. Works fully offline. Add ANTHROPIC_API_KEY or OPENAI_API_KEY to unlock AI-generated answers.

---

🔌 Claude Code Plugin

RepoMind ships with a first-class Claude Code MCP plugin — Claude automatically gets your codebase context before answering any question.

# Install the plugin (once)
bash plugin/install.sh

# Claude now has 5 new tools:
# repomind_ask · repomind_explain · repomind_overview · repomind_index · repomind_doctor

Claude Code will automatically call these tools when you ask about your code — no manual prompting needed.

Slash Commands

Drop .claude/commands/ into any project and get instant slash commands:

Command	What it does
/repomind-ask <question>	Semantic search + grounded answer
/repomind-explain <file>	Purpose, functions, flow of any file
/repomind-overview	Full project map with module descriptions

---

What You Get

$ repomind ask "How does the auth flow work?"

────────── 📁 Relevant Files ──────────
- src/auth/middleware.py
- src/auth/jwt.py
- src/users/service.py

────────── 📝 Memory ──────────
- Auth uses JWT stored in HttpOnly cookies
- Tokens expire after 24h

────────── 📄 Code Snippets ──────────
src/auth/middleware.py:12-48
  def validate_token(request):
    ...

────────── 🧠 Answer ──────────
Auth flow: request → JWT middleware → token validation →
user lookup → route handler. Tokens are stored in
HttpOnly cookies and validated on every request.

---

All Commands

Command	Description
repomind index .	Build semantic index for current repo
repomind index . --update	Re-index only changed files (fast)
repomind ask "<question>"	Ask anything about the codebase
repomind ask "<question>" --format prompt	Get a paste-ready AI prompt
repomind explain <file>	Deep-dive any file
repomind overview	Project structure + module map
repomind remember "<note>"	Save a note to codebase memory
repomind remember	List all saved notes
repomind forget <id>	Remove a note
repomind doctor	Check setup and environment

---

🧠 Memory

RepoMind has persistent memory per repo. Notes you save are automatically included in every future ask query — both in the output and in the LLM prompt.

repomind remember "Auth uses JWT stored in HttpOnly cookies"
repomind remember "Postgres 15 — schema lives in db/migrations/"
repomind remember "Never call UserService directly, go through the API layer"

repomind ask "How do I add a new endpoint?"
# → Answer is grounded in your code + your notes

Notes are stored in .repomind/memory.json — plain JSON, easy to commit or gitignore.

---

Free vs Premium

Feature	Free (no key)	Premium (API key)
Semantic file retrieval	✅	✅
Code snippets with line numbers	✅	✅
Memory injection	✅	✅
Project overview	✅	✅
AI-generated answers	❌	✅
File explanations (AI)	❌	✅
Module summaries (AI)	❌	✅

Free mode is fully useful. Premium mode adds natural language answers on top.

Set either key to activate:

export ANTHROPIC_API_KEY=sk-ant-...   # preferred
export OPENAI_API_KEY=sk-...          # also works

---

How It Works

repomind index .

  1. FileScanner   — walks your repo, skips binaries/noise
  2. CodeChunker   — splits files into overlapping chunks
  3. Embedder      — encodes chunks with all-MiniLM-L6-v2 (local)
  4. FAISS         — stores vectors in .repomind/index.faiss

repomind ask "..."

  1. Embed question  → same local model, no network call
  2. FAISS search    → top-k most relevant chunks
  3. LLM (optional)  → grounded answer with citations

Everything lives in .repomind/ inside your project. No global state. No cross-repo leakage.

---

Configuration

Optional config file at .repomind/config.toml:

# Use a different embedding model
embedding_model = "sentence-transformers/all-MiniLM-L6-v2"

# Max file size to index (default: 1MB)
max_file_size_bytes = 1048576

All settings can also be set via environment variables:

REPOMIND_EMBEDDING_MODEL=...
REPOMIND_MAX_FILE_SIZE_BYTES=...
ANTHROPIC_API_KEY=...
OPENAI_API_KEY=...

---

Installation

# Stable release
pip install repomind-cli

# Latest from source
pip install git+https://github.com/MBilalShabbir/repomind.git

Requirements: Python 3.10+

---

Claude Code Plugin — Full Setup

For teams that use Claude Code as their primary AI IDE:

# 1. Clone the repo (or copy the plugin/ folder)
git clone https://github.com/MBilalShabbir/repomind.git

# 2. Install the MCP plugin
bash repomind/plugin/install.sh

# 3. Index your project
cd your-project/
repomind index .

# 4. Open Claude Code — it now has your full codebase as context

Claude Code gains 5 MCP tools: repomind_ask, repomind_explain, repomind_overview, repomind_index, repomind_doctor.

It also gains 3 slash commands if you copy .claude/commands/ into your project.

---

Why Star This?

• 🔒 100% local embeddings — your code never leaves your machine
• 🧠 Persistent memory — notes survive across sessions
• ⚡ Claude Code MCP plugin — first-class integration, not an afterthought
• 🆓 Free mode is real — semantic search works without any API key
• 🔄 Incremental indexing — only re-embeds changed files
• 🗂️ Per-repo isolation — no cross-project contamination

---

Contributing

Stars, issues, and PRs are welcome.

git clone https://github.com/MBilalShabbir/repomind.git
cd repomind
pip install -e .

If RepoMind saved you from pasting your entire codebase into a chat window, leave a star ⭐ — it helps more developers find this.

---

Built by Bilal · MIT License

⭐ Star on GitHub · 📦 PyPI · 🐛 Issues