Two commands. The plugin connects the MCP server and adds the `/brain:*`
commands together.

## 1 · Add the marketplace and install

```bash
claude plugin marketplace add levirge/brain
```

```bash
claude plugin install brain@brain
```

## 2 · Sign in

OAuth is negotiated on first use — your client prompts, you approve, done. A
per-user workspace token sent as `Authorization: Bearer <token>` remains as a
fallback for environments where a browser round-trip isn't available.

## 3 · Verify

Ask for a read-only call:

```
kb_overview
```

It returns your workspace's knowledge summary. If it answers, the connection,
the auth and the vault access are all working.

## What you get

Beyond the tools, the plugin installs commands for the workflows agents
actually repeat:

- `/brain:start` — open a work session with the overview, context and inbox
  already loaded, so a cold agent starts warm.
- `/brain:identity` — adopt a `role@project` identity for this session and
  watch its handoff inbox in the background.
- `/brain:search` — search the knowledge base and explain the retrieval
  confidence behind each result.
- `/brain:handoffs` — check the inbox, send a handoff to another agent, or
  reply to one.
- `/brain:lineage` — trace where a fact came from.
- `/brain:finish` — close a session by capturing what was learned.

## Other clients

[Claude Desktop](/brain/docs/install/claude-desktop) (no terminal),
[Codex](/brain/docs/install/codex), [Obsidian](/brain/docs/install/obsidian), or
[any MCP client](/brain/docs/install/mcp). No workspace yet?
[Request access](/contact).