rekipedia
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Turn your codebase into readable format, for both Human and AI Agent.
rekipedia
Turn any repo into an AI-ready knowledge base — wiki, RAG, and MCP server included.
Why rekipedia?
| Problem | rekipedia |
|---|---|
| "Where does the auth logic live?" | reki ask "how does auth work?" → src/auth.py:42 |
| Onboarding new devs takes days | reki onboard . generates a guided walkthrough in seconds |
| AI agents hallucinate about your codebase | reki mcp gives agents a grounded knowledge base with citations |
| Refactor anxiety | reki hotspots surfaces hub nodes and bridge nodes before you touch anything |
| Wiki goes stale immediately | reki watch . auto-reindexes on every file save |
⚡ Quickstart
pip install rekipedia
# or: npx rekipedia
With LLM (richer wiki + Q&A)
export REKIPEDIA_API_KEY=sk-...
reki scan .
reki ask "how does authentication work?"
Key Features
🗂 reki scan — Instant knowledge store
Parses your repo into a SQLite knowledge store with symbols, relationships, and auto-generated wiki pages.
reki scan . # full scan with LLM summaries
reki scan . --no-llm # zero config, no API key required
💬 reki ask — Q&A grounded in your code
Answers questions with file:line citations. No hallucinations — every answer is backed by indexed source.
reki ask "what is the entry point?"
reki ask "which modules handle payments?" --brief
Answer: The entry point is src/main.py:12 — `App.run()` bootstraps the server.
Sources: src/main.py:12, src/server.py:34
🤖 reki mcp — MCP server for AI agents
Plug rekipedia directly into Claude Code, Cursor, or any MCP-aware agent.
reki mcp
Available tools: ask, search_nodes, get_context, get_relationships, get_hub_nodes, get_impact
🔥 reki hotspots — Architectural hotspot detection
Finds hub and bridge nodes — the files your whole codebase depends on.
reki hotspots
Hub nodes: src/core/engine.py (42 dependents)
Bridge nodes: src/adapters/db.py (connects 3 clusters)
🔄 reki update — Incremental updates
Only regenerates wiki pages affected by your changes.
reki update . --impact-only
MCP Integration
rekipedia ships a full MCP stdio server. Connect it to any MCP-aware agent in seconds.
Add to your .mcp.json:
{
"mcpServers": {
"rekipedia": {
"command": "reki",
"args": ["mcp"],
"cwd": "."
}
}
}
Claude Code and Cursor will automatically discover this config. The agent can then call:
ask— Q&A over the codebasesearch_nodes— symbol/file searchget_context— file-level contextget_relationships— dependency graph queriesget_hub_nodes— architectural hotspotsget_impact— change impact analysis
LLM Setup
rekipedia works without an LLM (--no-llm). To enable richer summaries and Q&A:
export REKIPEDIA_API_KEY=sk-... # OpenAI, Anthropic, or compatible
export REKIPEDIA_MODEL=gpt-4o # default: gpt-4o
Any OpenAI-compatible endpoint works:
export REKIPEDIA_API_KEY=ollama
export REKIPEDIA_MODEL=ollama/llama3
Commands
| Command | Description |
|---|---|
reki scan . |
Full scan — index symbols, generate wiki |
reki scan . --no-llm |
Scan without LLM, zero config |
reki ask "question" |
Ask anything about the codebase |
reki ask "question" --brief |
Short answer mode |
reki update . --impact-only |
Incremental update, affected pages only |
reki serve . |
Local web UI at http://127.0.0.1:7070 |
reki embed . |
Build FAISS semantic index |
reki export . --format md|zip|json|html |
Export the wiki |
reki diff |
Show impact of uncommitted changes |
reki hotspots |
Hub & bridge node detection |
reki refactor . --dry-run |
Preview refactor suggestions |
reki refactor . --apply |
Apply refactor suggestions |
reki mcp |
Start MCP stdio server |
reki review |
LLM-powered PR review |
reki watch . |
Auto-index on file change |
reki hook install |
Install git post-commit hook |
Coming Soon
- Hosted wiki — share your knowledge base with a link, no self-hosting required
- Team sync — collaborative wiki with conflict-free merge for distributed teams
- GitHub Action — auto-update wiki on every push
- VS Code extension — inline
reki askfrom your editor
Contributing
rekipedia is going MIT open source. Contributions welcome.
git clone https://github.com/unrealandychan/rekipedia.git
pip install -e ".[dev]"
Open an issue or PR — the bar is low and the maintainer is responsive.
Current version: 0.17.25 · PyPI · MIT License
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found