Skip to content
Wenlan

Lifecycle

Updates and Uninstall

Refresh Wenlan's local runtime, verify version health, restart MCP clients, and remove the service without losing data by accident.

Qi-Xuan LuUpdated 3 min read

At a glance

01

Update the app or local runtime, then check the daemon and reconnect your client if needed.

02

Stopping or uninstalling Wenlan is separate from deleting your library.

01

When to update

Update when release notes mention a setup fix, new MCP client support, service-management change, or runtime bug that affects your machine.

If everything is working, you do not need to chase every main-branch PR. Use the changelog to distinguish stable releases from unreleased work.

Read the changelog

02

Update the desktop app

When Wenlan offers an update, follow the prompt to install it. You can also open About Wenlan and choose Check for updates. If you install the macOS app manually, replace the old app with the new one and open it; quit Wenlan 0.17.0 or older first.

Read installation and update instructions

03

Refresh the local runtime

On macOS Apple Silicon with Node.js, run the installer with --version to check and refresh the runtime without rerunning setup. If it cannot check for a newer release, it can reuse the installed runtime and reports that; compare the printed version with the release you intend to install. Restart the daemon, then check status and doctor. Other platforms use their supported installation path.

Terminal (macOS Apple Silicon)
npx -y wenlan@latest --version
~/.wenlan/bin/wenlan restart
~/.wenlan/bin/wenlan status
~/.wenlan/bin/wenlan doctor

Read installation and update instructions

04

Claude Code plugin users

Claude Code plugin updates happen through Claude Code's plugin marketplace flow. After the plugin changes, restart Claude Code and run /wenlan again.

Run /wenlan to check whether Claude Code can reach Wenlan. If it cannot connect, follow its setup prompts.

Claude Code
/wenlan

05

MCP client settings

If wenlan-mcp moved, or a client still launches an old path, rerun wenlan connect for that client. Use --dry-run when you want to inspect the generated config first.

Most MCP clients need a restart after settings change. Verify by running the client's Wenlan doctor or a small capture/recall round trip.

MCP refresh
~/.wenlan/bin/wenlan connect codex --dry-run
~/.wenlan/bin/wenlan connect codex

06

Stop the background service

In the desktop app, turn off Run Wenlan in background at login in Settings, quit the app, then remove the app or run the Windows uninstaller. Your knowledge folders remain.

For a CLI installation, wenlan background off stops the daemon and disables autostart; it does not remove the service registration. Remove any Wenlan entries you added to client settings separately. For remaining files and credentials, consult the removal details.

Terminal
~/.wenlan/bin/wenlan background off

Read complete removal details

07

Before deleting data

Uninstalling the app or stopping the background service does not delete your library. Before deleting knowledge folders, decide whether you need them and make a backup. They can contain private captures, pages, and session notes.

Back up your library

Next

Upgrade Notes

Read the practical upgrade path for Wenlan releases: what to rerun, what to verify, and what changed in the current public runtime shape.

Read next