Skip to content

Matrix

Product Matrix

Map Wenlan's product surfaces, repositories, platforms, status, setup actions, and verification routes before choosing an install path.

Qi-Xuan LuUpdated 6 min read

At a glance

01

Wenlan turns captures and sources into a source-backed LLM wiki; the daemon owns the data and retrieval boundary behind every client.

02

Runtime platform support and desktop app release support are separate rows, not one blended promise.

01

Product surfaces

Use this matrix before picking an install route. Wenlan is the source-backed LLM wiki; the daemon/runtime owns behavior, while the CLI, local and remote MCP, Claude Code plugin, Codex plugin, ChatGPT, other clients, and optional desktop app are ways to reach it.

The daemon owns the database, pages, sessions, and retrieval behavior. Client surfaces should be debugged by checking daemon health first, then the client-specific config.

  • daemon/runtime - owner: wenlan; released source of truth; run npx -y wenlan setup; verify with ~/.wenlan/bin/wenlan status.
  • CLI - owner: wenlan; released with the runtime; run ~/.wenlan/bin/wenlan doctor before debugging clients.
  • MCP connector - owner: wenlan; released as wenlan-mcp; run wenlan connect <client>; verify with wenlan connect codex --dry-run.
  • Claude Code plugin - owner: wenlan; released plugin workflow; install wenlan@7xuanlu; verify with /setup.
  • Codex plugin - owner: wenlan; released Codex plugin surface; use the plugin-codex setup skill; verify with wenlan connect codex --dry-run.
  • ChatGPT and Claude.ai remote MCP - owner: wenlan plus wenlan-app; released Streamable HTTP MCP endpoint with a guided desktop Remote Access path; verify the generated URL before adding a custom app or connector.
  • other MCP clients - owner: wenlan; client-specific config; run wenlan connect cursor or the matching client; restart the client, then call context.
  • optional desktop app - owner: wenlan-app; optional daemon client; download the current app release; verify the app talks to localhost:7878.
  • source build - owner: wenlan; contributor/dev path; run cargo build --workspace; verify with cargo test --workspace.
  • eval/docs provenance - owner: wenlan; CI/release guarded docs; update the README eval block and check README translations.

02

Platform boundaries

Do not collapse runtime support and desktop app support into one claim. The current product release workflow publishes the runtime for macOS Apple Silicon, Linux x86_64, Linux aarch64 glibc, and Windows x86_64. The optional desktop app release path is narrower and currently targets macOS Apple Silicon.

macOS Intel still has a launchd service model in the code path, but there is no current prebuilt runtime or desktop app target in the public release workflow. Treat that as source/dev-only until a release workflow adds an artifact.

  • macOS Apple Silicon - current prebuilt runtime, launchd user agent, and current desktop app target aarch64-apple-darwin.
  • macOS Intel - no current prebuilt runtime in the release workflow; launchd code path exists, but treat it as source/dev-only; no current desktop app target.
  • Linux x86_64 - current prebuilt runtime and systemd user unit; no current desktop app target.
  • Linux aarch64 glibc - current prebuilt runtime and systemd user unit; no current desktop app target.
  • Windows x86_64 - current prebuilt runtime and Task Scheduler ONLOGON task; no current desktop app target.
Read platform support

03

Start path

If you are new to Wenlan, start with setup instead of choosing packages by hand. The setup path installs the local runtime under ~/.wenlan/bin, verifies the daemon, and gives MCP clients a stable connector path.

Get started

04

Daily use

Once setup is green, the daily loop is brief or context at session start, capture when a durable fact appears, recall when history matters, and handoff when a work session should survive the chat.

Read daily workflow

05

Concept map

Use the concept docs when you need to explain memory types, review queues, spaces, source-backed pages, or why a client is not the source of truth.

Read core concepts

06

Architecture boundary

Use the architecture page when a bug report or integration question needs ownership. Daemon behavior belongs in the main Wenlan repo; desktop UI behavior belongs in the app repo; the website owns public education and SEO surfaces.

Read architecture

07

Package map

Use the packages page when names are confusing: wenlan is the setup/plugin package, wenlan-mcp is the connector, wenlan-types is the shared wire type crate, and GitHub Releases are the stable artifact record.

Read packages

08

MCP clients

Use the MCP client docs for Codex, Cursor, Claude Desktop, VS Code, Gemini CLI, ChatGPT, Claude.ai, and manual fallback config. Local clients use wenlan connect; web clients use Streamable HTTP MCP through a URL you control.

Connect MCP clients

09

Optional desktop app

The desktop app is a GUI client over the same daemon, not a requirement. Current app releases live in the wenlan-app repo and should be verified against the app version, .wenlan-backend-version pin, and release target before public copy claims support.

Read desktop app status

10

Troubleshooting

When something fails, diagnose in order: daemon health, local CLI, MCP generated config, client restart state, then app-specific UI. That order keeps client bugs from being mistaken for product-data drift.

Troubleshoot setup

11

Release status

Shipped facts come from version.txt, CHANGELOG.md, release workflows, and repo-owned app pins. Merged main-branch work is not a public release until a release entry and artifact exist.

Read release status

12

Route checklist

This route checklist is intentionally public. It is the website-level contract for whether users can move from setup, to concepts, to platform support, to troubleshooting without relying on private repo knowledge.

  • Install first runtime: /docs/get-started.
  • Run the daily memory loop: /docs/daily-workflow.
  • Learn concepts: /docs/core-concepts.
  • See daemon/client boundary: /docs/architecture.
  • Map packages and registries: /docs/packages-and-registries.
  • Check platform support: /docs/platforms.
  • Connect MCP clients: /docs/mcp-clients.
  • Understand optional GUI: /docs/desktop-app.
  • Fix setup: /docs/troubleshooting.
  • Know shipped versus unreleased work: /docs/releases-and-versioning.

Next

Commands and Tools

The essential Claude Code and Codex plugin commands, CLI commands, and MCP tools for running Wenlan day to day.

Read next