This repository was archived by the owner on Jun 13, 2026. It is now read-only.
Repository navigation
v0.1.0 — Initial release
Initial public release. An opencode plugin for The Librarian — durable memory + cross-harness session lifecycle, backed by a remote Librarian MCP server.
Install (once published to npm)
opencode plugin the-librarian-opencode-pluginThen add the mcpServers.librarian block from the README to your opencode.json and set the env vars (LIBRARIAN_MCP_URL, LIBRARIAN_AGENT_TOKEN).
Highlights
- Pre-LLM privacy gate via
chat.message— off-record markers stop recording on the same turn (no one-turn lag). - Seven
/lib-session-*slash commands auto-installed to~/.config/opencode/commands/on first run (sentinel-gated; never clobbers user edits). - Automatic session lifecycle: bootstrap on
session.created(race-safe), per-turn record onsession.idle, checkpoint onsession.compacted+ debounced threshold (≥ 10 min OR ≥ 20 turns). - Stale-active session reconciliation on every
session.created. - Direct port of canonical TS privacy detector (one fewer drift surface than the Codex JS port or the Hermes Python port).
- Atomic state store + cross-process
withLockverified on Bun. - HTTP MCP client:
redirect: "error", rejects embedded credentials / query strings / fragments, 8 MiB cap, 15 s timeout.
Family
Final plugin in the Librarian family. Siblings:
- the-librarian-claude-plugin
- the-librarian-codex-plugin
- the-librarian-hermes-plugin
- the-librarian-pi-extension
See CHANGELOG.md for the full feature list, security posture, and known limitations.