Wenlan Upgrade Notes

At a glance

Check the notes below when upgrading from an older version.

For the ordinary update process, use Updates and Uninstall.

Read release state first

Wenlan moves quickly, so distinguish released packages from main-branch work. The changelog and GitHub Releases describe what is shipped; merged PRs can describe work that is not in your installed package yet.

If a doc says an experiment is on main or opt-in, do not treat it as part of the stable runtime until a release page or changelog entry says so.

Read the changelog

Normal updates

For the normal update process, plugin updates, client restarts, and data safety, follow Updates and Uninstall. For a machine migration, back up the library first.

Update or uninstall Wenlan

Plugin commands from v0.19.2

From v0.19.2 the Claude Code and Codex plugins have one entry. The old standalone commands are gone with no transition period, so update scripts, notes, and habits that still type them.

/brief, /capture, /recall, and /handoff are unchanged. Everything else is a word after /wenlan in Claude Code, or after $wenlan in Codex.

Old to new

/wenlan:setup   ->  /wenlan  (or /wenlan setup to repair)
/setup          ->  /wenlan setup
/help           ->  /wenlan
/distill        ->  /wenlan distill
/pages          ->  /wenlan pages
/lint           ->  /wenlan lint
/curate         ->  /wenlan curate
/forget         ->  /wenlan forget
$wenlan:lint    ->  $wenlan lint  (Codex; same pattern for the others)

Changes in v0.20.0

/wenlan map is now /wenlan wiki ($wenlan wiki in Codex), with no alias. It plans the repository's pages and writes the missing ones; /wenlan steep keeps them current.

Steeping is Automatic or On demand. New installs start On demand, where your AI tool steeps as it works and /wenlan steep finishes the rest. Lock pages I've written is on for new installs (renamed Ask me first on pages I wrote in v0.20.1); a configuration written before v0.20.0 keeps it off until you turn it on.

Old to new

/wenlan map  ->  /wenlan wiki
$wenlan map  ->  $wenlan wiki  (Codex)

Packages and Registries

Know which Wenlan package name maps to the plugin, runtime setup, MCP connector, Rust crates, and release binaries.