Lifecycle
Updates and Uninstall
Refresh Wenlan's local runtime, verify version health, restart MCP clients, and remove the service without losing data by accident.
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.
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.
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.
npx -y wenlan@latest --version
~/.wenlan/bin/wenlan restart
~/.wenlan/bin/wenlan status
~/.wenlan/bin/wenlan doctor04
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.
/wenlan05
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.
~/.wenlan/bin/wenlan connect codex --dry-run
~/.wenlan/bin/wenlan connect codex06
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.
~/.wenlan/bin/wenlan background off07
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.
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