Configuration
Wenlan Configuration
Configure Wenlan spaces, MCP clients, daemon bind address, local paths, models, and keys without editing the database by hand.
At a glance
01
Use the desktop settings, CLI, or plugin setup to configure the relevant component.
02
Environment overrides apply to the process that receives them; see the variable reference for names and defaults.
01
Configuration quick path
Use Settings in the desktop app or the CLI and plugin setup for the part you want to change. Client configuration belongs to the client; daemon settings affect the local service. Run doctor after setup changes.
02
Spaces
Spaces separate work, personal, client, and project memory without requiring multiple Wenlan installs. Set a space for a shell session with WENLAN_SPACE, or define stable spaces in ~/.wenlan/spaces.toml.
List your Spaces first. If client-a does not exist, create it before launching Claude Code with that strict Space pin.
wenlan spaces list
# If client-a is absent, create it first:
wenlan spaces add client-a
WENLAN_SPACE=client-a claude03
MCP client wiring
Each local client stores its own MCP configuration. Use wenlan connect and inspect its dry run before changing a client file.
04
Using Claude Code
For an example of using Wenlan memory in Claude Code after setup, follow the Claude Code memory guide.
05
Daemon bind address
The daemon normally listens on loopback. A non-loopback bind exposes its API beyond the local machine, so change it only when you understand the privacy implications. Set variables in the daemon process environment before it starts.
06
Local files
The app and daemon use local data locations; client configuration is stored separately by each client. Use the backup guide to identify the files to preserve.
07
Models and keys
Configure optional daemon-side models and keys in Wenlan. The connected AI client uses its own provider settings.
Next
Environment Variables
Know which Wenlan environment variables are normal configuration, which are development-only, and which belong to eval or Windows repair paths.
Read next