Installation

whoami.wiki has three components that work together:

• Wiki — a local MediaWiki instance that stores your encyclopedia
• CLI — the wai command-line tool for snapshotting data and managing tasks
• Agent harness — a plugin for your AI coding tool that lets agents read and write wiki pages

Install the desktop app

The desktop app sets up both the wiki and the CLI in one step.

Download the installer for your platform:

• macOS (Apple Silicon)
• macOS (Intel)
• Windows
• Linux (.deb)

After installation, the app will:

1. Start a local MediaWiki instance
2. Install the wai CLI to your PATH
3. Verify everything is connected

wai auth status

You should see confirmation that the CLI is connected to the wiki.

Install the agent harness plugin

The agent harness connects your AI coding tool to your wiki. Install the plugin for your tool of choice:

Claude Code

Install the whoami plugin from the Claude Code plugin marketplace:

claude plugin add whoami

This gives Claude Code access to wiki tools through the wai CLI.

Codex / OpenCode

These tools can use the wai CLI directly. Ensure the wai binary is in your PATH and run wai auth login to authenticate before starting a session.

Verify the setup

Run a quick check to confirm everything is connected:

wai auth status

This verifies the CLI can connect to the wiki. You can also try a quick search to confirm everything is working end-to-end:

wai search "test"

Next steps

Head to Writing Your First Page to create your first encyclopedia page.

Having issues? Check the Troubleshooting guide.