Skip to content
Wenlan

Configuration

Wenlan Configuration

Configure Wenlan spaces, MCP clients, daemon bind address, local paths, models, and keys without editing the database by hand.

Qi-Xuan LuUpdated 2 min read

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.

Get started

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.

Space config
wenlan spaces list
# If client-a is absent, create it first:
wenlan spaces add client-a
WENLAN_SPACE=client-a claude

03

MCP client wiring

Each local client stores its own MCP configuration. Use wenlan connect and inspect its dry run before changing a client file.

Connect MCP clients

04

Using Claude Code

For an example of using Wenlan memory in Claude Code after setup, follow the Claude Code memory guide.

Read 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.

Look up environment variables

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.

Find and back up data

07

Models and keys

Configure optional daemon-side models and keys in Wenlan. The connected AI client uses its own provider settings.

Read models and keys

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