Claude Wiki

Claude Wiki generates and maintains agent-friendly wikis for codebases using Claude Code — powered by your existing Claude subscription, no API key required.

Inspired by OpenWiki, rebuilt on top of Claude Code so that documentation generation runs inside your Claude Pro/Max subscription instead of requiring separate API credentials.

How it works

Anthropic's policy does not allow the Claude Agent SDK to use claude.ai subscription auth. Claude Wiki therefore takes a different architecture:

• Claude Code plugin — the wiki generation logic lives in plugin commands, skills, and subagents that run inside your Claude Code session (fully covered by your subscription).
• Thin CLI wrapper — claude-wiki shells out to the locally installed claude CLI in headless mode (claude -p), so the same logic works from your terminal or CI. In CI, use a long-lived OAuth token from claude setup-token (CLAUDE_CODE_OAUTH_TOKEN).

Install

As a Claude Code plugin

/plugin marketplace add roboco-io/plugins
/plugin install claude-wiki@roboco-plugins

Then inside any repository:

/claude-wiki:init      # generate the initial wiki
/claude-wiki:update    # incrementally refresh the wiki

As a CLI

npm install -g claude-wiki

claude-wiki init       # generate the initial wiki
claude-wiki update     # incrementally refresh the wiki

Requires the Claude Code CLI to be installed and logged in.

Output formats

Claude Wiki supports two wiki layouts, selectable at init time:

| Format | Layout | Best for | |--------|--------|----------| | llm-wiki (default) | wiki/index.md + [[wiki-link]] cross-references (Karpathy LLM Wiki pattern, Obsidian-compatible) | Agent-first knowledge bases | | openwiki | openwiki/quickstart.md + architecture/, operations/ sections | OpenWiki-compatible repositories |

Usage

Both interfaces expose the same two operations. init requires no flags for the default format; update takes none at all — it reads the format from the existing wiki's metadata.

# Plugin (inside a Claude Code session)
/claude-wiki:init                        # generate wiki/ (llm-wiki format, default)
/claude-wiki:init --format openwiki      # generate openwiki/ instead
/claude-wiki:update                      # refresh the existing wiki

# CLI (terminal or CI)
claude-wiki init                         # same as above
claude-wiki init --format openwiki
claude-wiki update

init refuses to run if the target wiki root already has a claude-wiki.json (run update instead, or delete the wiki root to force a rebuild). update is diff-scoped from the last recorded commit and may be a no-op if nothing relevant changed since then.

Headless / CI usage

The CLI shells out to your local claude binary in headless mode (claude -p), so it needs the Claude Code CLI installed and authenticated:

• Locally: log in once by running claude and using the /login slash command; claude-wiki reuses that session.
• In CI: generate a long-lived OAuth token with claude setup-token (works with a Claude Pro/Max subscription, no API key), store it as a secret, and export it as CLAUDE_CODE_OAUTH_TOKEN. See examples/claude-wiki-update.yml for a complete GitHub Actions workflow that installs @anthropic-ai/claude-code + claude-wiki, runs claude-wiki update on a schedule, and opens a PR with the changes.

export CLAUDE_CODE_OAUTH_TOKEN=...   # from `claude setup-token`
claude-wiki update

The claude-wiki.json metadata contract

Every generated wiki root (wiki/ or openwiki/) contains a claude-wiki.json file that update reads and rewrites on every run, including no-ops:

{
  "version": 1,
  "format": "llm-wiki",
  "lastRunCommit": "<git HEAD sha at generation time>",
  "lastRunAt": "<UTC timestamp, e.g. 2026-07-12T00:00:00Z>"
}

format determines the wiki layout regardless of which directory it's found in; lastRunCommit scopes the diff that the next update inspects.

Why no API key

All wiki-generation intelligence runs as Claude Code skill/command prompts executed by your local claude binary, so token usage is covered by your Claude Pro/Max subscription instead of a separate Anthropic API key.

Security model

The headless CLI (claude-wiki init / claude-wiki update) runs claude -p with --permission-mode acceptEdits, granting the Write and Edit tools without per-file confirmation. The rule that writes stay under the wiki root (wiki/ or openwiki/) is enforced by the skill's prompt instructions, not by OS-level sandboxing — a sufficiently adversarial repository could in principle induce writes elsewhere. Repository content (source, docs, commit messages) is also fed to the model as input. Only run Claude Wiki on repositories you trust, and review generated wiki changes (e.g. the PR opened by the example CI workflow) before merging.

Development

npm install
npm run build
npm test

See docs/DESIGN.md for architecture decisions.

License

MIT