open-wiki

The open-source alternative to Google's Code Wiki — with MCP.

Index any codebase with tree-sitter, generate docs with your LLM, serve them through a full-featured docs site, and expose everything as tools for coding agents via MCP. Like Notion for code agents.

ow /path/to/your/project

---

Install

npm install -g open-wiki

---

Quick Start

# 1. Set your API key
ow config set-key anthropic sk-ant-...

# 2. Index a project
ow /path/to/project

# 3. Open the docs
ow serve
# → http://localhost:8383

---

Commands

ow [path]

Index a project and generate documentation. Defaults to the current directory.

ow                            # index current directory
ow /path/to/project           # index a specific path
ow . --force                  # re-index all files (ignore cache)
ow . --name myapp             # override the project name
ow . --provider openai        # use a specific LLM provider

Flag	Description
-p, --provider <name>	LLM provider: anthropic, openai, google
--name <name>	Override project name (defaults to directory name)
--force	Re-index all files regardless of changes

---

ow serve

Start the docs server.

ow serve                      # start on default port 8383
ow serve --port 3000          # custom port

Flag	Description
-p, --port <port>	Port to listen on (default: 8383)

---

ow config

Manage API keys and provider settings.

ow config set-key anthropic sk-ant-...     # set Anthropic key
ow config set-key openai sk-...            # set OpenAI key
ow config set-key google AIza...           # set Google key
ow config set-default openai              # change default provider
ow config list                            # show all configured providers

Supported providers: anthropic, openai, google

---

ow list

List all indexed projects.

ow list

---

ow mcp

MCP server for coding agents. Exposes your indexed docs as tools.

ow mcp install    # register with Claude Code (run once)
ow mcp            # start the stdio MCP server (Claude Code does this automatically)

After ow mcp install, Claude Code gets 5 tools:

Tool	What it does
list_projects	List all indexed projects with file and symbol counts
get_project_overview	Get the architecture overview and mermaid diagram for a project
get_file_doc	Get documentation for a specific file
search_docs	Full-text search across all docs in a project
get_symbols	List all functions, classes, and interfaces in a file or project

---

ow setup

Manage the underlying docs app.

ow setup            # install the docs app (runs automatically on first use)
ow setup --reset    # wipe and reinstall from scratch

---

How It Works

1. Index — tree-sitter parses your source files and extracts symbols, signatures, and imports
2. Generate — one structured LLM call per file produces a summary and per-symbol docs
3. Diff — only changed files are re-processed on subsequent runs
4. Serve — a Next.js + fumadocs app renders the generated MDX with syntax highlighting, mermaid diagrams, and AI chat
5. MCP — the stdio server reads directly from the SQLite index and MDX files

---

Supported Languages

• TypeScript / JavaScript (.ts, .tsx, .js, .jsx)
• Python (.py)

---

License

MIT