BackReleased 2026.05.04

v3.4.0
Team Brain.

Two flagship features and one structural refresh. Team Brain ships the Graphiti integration as a sidecar with a one-command wizard. Drift Detection answers the question every team eventually asks: why does my MCP setup feel different from theirs?

npm@3.4.0 GitHub release

Team Brain. Graphiti integration.

Run opalserve enable graph. The wizard:

Detects Python 3.10+ across py, python3, and python (Windows-aware).
Asks you to pick an LLM provider. OpenAI, Anthropic, Ollama, or skip.
Optionally pip install graphiti-core[kuzu] to your user site.
Persists configuration to ~/.opalserve/graph/config.json.

After enabling, opalserve start automatically spawns the Graphiti MCP server as a detached sidecar. PID is tracked in ~/.opalserve/graph/sidecar.pid. Logs go to ~/.opalserve/graph/sidecar.log.

lifecycle

$opalserve graph status# config + sidecar state
$opalserve graph spawn# manual start
$opalserve graph reset# confirmation prompt, then wipe data
$opalserve disable graph# stop sidecar, preserve data

opalserve doctor reports graph health. Python availability, graphiti-core import status, sidecar PID liveness.

Preview status

This release ships the foundation. Wizard, configuration, sidecar lifecycle, doctor checks, CLI commands. The auto-ingestion pipeline (context docs and tool calls feeding episodes into the graph) is on the roadmap. The graph is fully usable today via manual graph add or via the Graphiti MCP tools.

Drift Detection.

opalserve drift compares the local client’s ~/.opalserve/config.jsonserver entries against the team’s team_servers table and renders a color-coded report.

Status	Meaning
`match`	Server identical on both sides.
`drift`	Same name, different config. Specific changed fields surfaced.
`missing`	Registered with team but not on this client.
`local-only`	Present locally but not on team server.

Backed by POST /api/v1/drift. The dashboard’s new Drift tab calls the same endpoint and renders the table with summary stats.

Dashboard reorganization.

The sidebar is now grouped into three sections plus Settings, matching how teams actually use the dashboard.

Section	Pages	Purpose
Registry	Servers, Tools	What’s available.
Connections	Users, Context	Who shares what.
Observe	Overview, Drift, Graph	Insights and audit.

Two new pages. Drift (summary cards plus entries table) and Graph (preview banner with the CLI step-by-step).

Tests and reliability.

75 tests passing across 8 files. New: graph.test.ts (9 tests), drift.test.ts (5 integration tests). Coverage via pnpm test:coverage.

CI matrix: ubuntu × {Node 20, 22, 24}, macos × Node 22, windows × Node 22. Separate security audit job.

Upgrade.

upgrade

$npm install -g opalserve@3.4.0
$opalserve doctor

No migration required. Drift detection and the dashboard refresh both surface automatically.

Read the Team Brain guide Home