rekipedia

library0.21.2jsnpmunverified

Agentic repository-to-wiki tool that scans any codebase into a portable SQLite knowledge store with wiki pages, diagrams, and grounded Q&A. Current stable version: 0.21.2 (npm) / 0.21.2 (PyPI). Release cadence: weekly. Key differentiators: relationship confidence scoring (EXTRACTED/INFERRED/AMBIGUOUS), design rationale extraction (# NOTE, # HACK, # WHY), god nodes detection, interactive D3.js dependency graph, git hooks for auto-rebuild, refactoring analysis (code smells, circular dependencies, dead code), context slicing reducing token usage by 40-60%, hybrid RAG with FAISS, and incremental updates. Supports multiple installation methods (npm, pip, Homebrew, uv) and multiple LLM providers via litellm.

ai-ml devops

npm install rekipedia

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REKIPEDIA

rekipedia

ai-mljavascriptv0.21.2

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.

default

✓ import rekipedia from 'rekipedia'

✗ const rekipedia = require('rekipedia')

ESM-only since v0.18.0; CommonJS require() will fail with ERR_REQUIRE_ESM

scan

✓ import { scan } from 'rekipedia'

✗ import scan from 'rekipedia/scan'

Named export from main package, not a subpath export

ask

✓ import { ask } from 'rekipedia'

✗ import { ask } from 'rekipedia/ask'

Same as scan - main package named export

ScanResult

✓ import { ScanResult } from 'rekipedia'

✗ import type { ScanResult } from 'rekipedia'

ScanResult is a runtime class, not just a type; type-only import may cause issues in some bundlers

rekipedia

✓ import * as rekipedia from 'rekipedia'

✗ const rekipedia = require('rekipedia')

Namespace import works but prefer named imports for tree-shaking

Scan a repository and ask a grounded question about the auth flow, getting file:line citations.

import { scan, ask } from 'rekipedia'; const result = await scan('/path/to/repo'); console.log(`Pages: ${result.page_count}, Symbols: ${result.symbol_count}`); const answer = await ask('/path/to/repo', 'How does the auth flow work?'); console.log(answer.text); for (const citation of answer.citations) { console.log(` ${citation.file}:${citation.line}`); }

Debug

Known issues

breakingESM-only since v0.18.0 - CommonJS require() will fail

fix

Use import statements or switch to dynamic import()

affects: >=0.18.0

breakingPython CLI command changed from 'rekipedia' to 'reki' in v0.20.0

fix

Use 'reki' subcommand instead of 'rekipedia' (e.g., 'reki scan .' instead of 'rekipedia scan .')

affects: >=0.20.0

breakingConfig file location moved from .rekipedia/config.yml to .rekipedia/config.yaml in v0.19.0

fix

Rename your config.yml to config.yaml or re-initialize with 'npx rekipedia init .'

affects: >=0.19.0

deprecatedThe '--no-llm' flag is deprecated in favor of '--mode static'

fix

Use 'reki scan . --mode static' instead

affects: >=0.21.0

gotchaFAISS index must be rebuilt when the codebase changes - incremental update does NOT rebuild the index

fix

Run 'reki embed .' after 'reki update .' to rebuild the semantic search index

affects: all

gotchaRAG support requires faiss-cpu and numpy which are not installed by default

fix

Install with 'pip install "rekipedia[rag]"' or 'npm install rekipedia --include=optional'

affects: all

Errors

Common errors & fixes

Error: Must use import to load ES Module: /path/to/node_modules/rekipedia/index.js

Using CommonJS require() with an ESM-only package (v0.18.0+)

fix

Change your module system to ESM (e.g., add '\"type\": \"module\"' to package.json)

ModuleNotFoundError: No module named 'faiss'

Trying to use RAG features without installing the optional dependencies

fix

pip install "rekipedia[rag]"

rekipedia: command not found

Python CLI renamed to 'reki' in v0.20.0

fix

Use 'reki' instead of 'rekipedia' for CLI commands

Error: config.yml not found in .rekipedia/

Config file renamed from .yml to .yaml in v0.19.0

fix

Rename .rekipedia/config.yml to .rekipedia/config.yaml or run 'rekipedia init .' again

Upgrade

Version history

0.21.2latest on npm

Audit

Dependencies

sqlite3requiredRuntime database for storing extracted knowledge (SQLite is bundled with Python and Node.js)

@anthropic-ai/sdkoptionalOnly when using Claude as the LLM provider for Q&A

faiss-cpuoptionalRequired only for RAG (semantic search) support - adds ~100MB

numpyoptionalDependency of faiss-cpu, needed for RAG embeddings

Agent activity

8 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/unrealandychan/rekipedia ↗

packagerekipedia ↗

homepagehttps://github.com/unrealandychan/rekipedia#readme ↗