How It Works

autowiki has two parts that work together:

1. A Claude Code plugin that builds and maintains a wiki for your repo. Run /autowiki:init and Claude explores your codebase, identifies key concepts, and writes structured markdown documentation in a wiki/ directory. The wiki updates incrementally as your code changes — no need to regenerate from scratch.

2. An npm package (npx autowiki) that serves the wiki as a polished, searchable website. Dark mode, sidebar navigation, full-text search, wikilinks between pages — all running locally with zero configuration.

The generated wiki is immediately useful for AI agents as raw markdown (plus llms.txt), and just as useful for humans via the web UI.

Getting Started

Install the Claude Code plugin

/install-plugin github:anyweez/autowiki

Generate your wiki

/autowiki:init

Claude will explore your codebase and create a wiki/ directory with structured documentation.

Browse it

npx autowiki

Open http://localhost:3000 and you're in.

Plugin Commands

| Command | Description | |---------|-------------| | /autowiki:init | Generate a wiki from scratch by exploring the codebase | | /autowiki:update | Update the wiki to reflect recent code changes | | /autowiki:reorganize | Analyze wiki structure and suggest improvements |

The wiki also auto-updates after Claude Code tasks complete. Disable this in wiki/.config.yml:

auto_update: false

Web Server Options

npx autowiki [options]

  --port <number>     Port to listen on (default: 3000)
  --wiki-dir <path>   Wiki directory (default: auto-detect)
  --export            Export static HTML files
  --output <path>     Export directory (default: wiki-html/)
  --open              Open browser automatically

Wiki Format

Pages are markdown files with YAML frontmatter, organized by type:

wiki/
├── overview.md       # Repository overview
├── concepts/         # Architecture, design patterns
├── guides/           # How-to documentation
└── reference/        # API and config reference

Pages link to each other with [[wikilinks]] and track which source files they document, so the wiki knows what to update when code changes.

Requirements

• Claude Code (for the plugin)
• Node.js 16+ (for the web server)

License

Apache 2