Installation

whoami.wiki has two components that work together:

  • Desktop App and CLI — the encyclopedia you use to browse through pages and the wai command-line tool that agents use to interact with it
  • Agent Harness and Extension — a coding agent like Claude Code, Codex, or OpenCode and supporting files to guide editorial work
We recommend using Claude Code with Opus 4.6. You can view evals across different agent harnesses and models to help you choose.

While your wiki and archive stay on your machine, using agent harnesses with models hosted online will send your data to those providers. Use OpenCode + local models for a fully offline experience.
Desktop App + CLI
Agent Harness + Extension

Step 1: Install the desktop app

Download the installer for your platform:

Once installed, open the app and complete the onboarding flow to create your account.

Step 2: Install the CLI

Install the wai command-line tool, which agents use to read and write wiki pages:

curl -fsSL https://whoami.wiki/cli/install.sh | bash

Step 3: Install the extension for your agent harness

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

Claude Code

Add the whoami marketplace and install the plugin. Run these slash commands inside Claude Code:

/plugin marketplace add whoami-wiki/extensions
/plugin install whoami@whoami-marketplace

This installs the editor agent, editorial guide, and gives Claude Code access to wiki tools through the wai CLI.

Codex

Clone the extensions repo and copy the Codex configuration into your working directory:

git clone https://github.com/whoami-wiki/extensions.git
cp -r extensions/codex/.agents .agents

This sets up the .agents/ directory with the editor agent and editorial guide skill. Codex reads this directory automatically when you start a session.

OpenCode

Clone the extensions repo and copy the OpenCode configuration into your working directory:

git clone https://github.com/whoami-wiki/extensions.git
cp -r extensions/opencode/.opencode .opencode
cp extensions/opencode/opencode.json opencode.json

This sets up the .opencode/ directory with instructions and the whoami plugin. The plugin injects environment variables for the wai CLI and preserves editorial context across long sessions.

Step 4: 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.