Point your agent at it. BYOK.

1 · Install Ouroboros

Packaging is in flight. When it ships you'll get one-line installers for Linux (.deb), macOS (.dmg), and Windows (.exe) that drop the daemon, the tray app, and the CLI in the right places. Until then, the source is closed and the install path is "build it yourself with bun."

2 · Mint a connection

Open the tray and click New connection. You'll pick:

• Display name — shows up in your audit log and in coordination posts (e.g. OpusDev-DataHome).
• Profile — full (read + write), read-only, or scoped read.
• Entity scope — which entities the agent can see. A connection scoped to ["acme"] literally cannot return rows for any other entity, because every read query injects AND e.id IN (?) in SQL at the daemon layer.

Click Approve. The tray writes a bearer token to a file only your OS user can read at mode 0600. You're done in the tray.

3 · Point your agent at it

Drop the bearer into your agent's MCP config. Three of the most common shapes:

Claude Code

Add to ~/.config/claude/mcp.json (or per-project .mcp.json):

{
  "mcpServers": {
    "sophia": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": {
        "Authorization": "Bearer ${SOPHIA_BEARER}"
      }
    }
  }
}

Set SOPHIA_BEARER in your shell, restart Claude Code, and the sophia.* tools light up.

Codex

Add to ~/.config/codex/mcp.toml:

# ~/.config/codex/mcp.toml
[[mcp_servers]]
name = "sophia"
transport = "http"
url = "http://127.0.0.1:8765/mcp"

[mcp_servers.headers]
Authorization = "Bearer ${SOPHIA_BEARER}"

Cursor

Add to .cursor/mcp.json at your repo root:

// .cursor/mcp.json
{
  "mcpServers": {
    "sophia": {
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer YOUR_BEARER_HERE" }
    }
  }
}

Custom agent

Any MCP-speaking client works. Point it at http://127.0.0.1:8765/mcp with the bearer in the Authorization header. Streamable HTTP and stdio transports both supported.

The first call

From any agent, the first call is always the same — a single tool call that orients the whole session. One call replaces six.

// First call from any agent — replaces six.
const ctx = await sophia.orient();
// → sync status · hot entities · open questions ·
//   recent corrections you've made · which skills
//   are loaded · what to call next.

// One TypeScript snippet, multiple sophia.* calls,
// one round trip. The daemon runs it inside a
// sandboxed V8 isolate.
const result = await sophia.execute_code({ code: `
  const [facts, docs] = await Promise.all([
    sophia.queryKnowledge({ entity_name: 'acme', limit: 20 }),
    sophia.searchDocuments({ query: 'lease amendment', k: 10 }),
  ]);
  return { facts, docs };
` });

A fresh agent session is fully oriented in roughly 1,800 tokens — it knows what you were working on, what you corrected yesterday, and which entities are in scope for this connection.