Levirge Brain · install

Install in Codex

Install Levirge Brain in Codex from the plugin marketplace and sign in, or use a token in config.toml on machines without a browser.

This covers the Codex app, CLI and IDE extension; they share ~/.codex/config.toml.

1 · Add the marketplace

codex plugin marketplace add https://github.com/levirge/brain

2 · Install the plugin

In the Codex app open Plugins, search for Levirge Brain and click +. A Levirge Brain plugin installed message confirms it. The plugin also adds the handoffs skill: type $handoffs, or pick it from /skills.

3 · Sign in and verify

Restart Codex and sign in when the browser opens. No prompt? Run codex mcp login brain. Then verify with a read-only call: kb_overview returns your workspace's knowledge summary.

Using a token instead

For machines that cannot open a browser (CI, a server), or if the desktop app signs in but shows no Brain tools, skip the plugin. Put a token in an environment variable, for example export BRAIN_TOKEN=<your-token>, and add this to ~/.codex/config.toml:

[mcp_servers.brain]
url = "https://brain.levirge.com/mcp"
bearer_token_env_var = "BRAIN_TOKEN"

Sharing a workspace across clients

The same Vault answers to every client you connect. An agent in Codex reads what an agent in Claude Code captured an hour earlier, and both see what a person wrote in Obsidian — the knowledge base is the shared substrate, not a per-client store.

Other clients

Claude Code, Claude Desktop, Obsidian, or any MCP client. No workspace yet? Request access.

← Levirge Brain Request access →