The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Matryca Plumber
Local-first AI daemon for Logseq OG: background semantic indexing, link hygiene, and agent-ready CLI/MCP — edits Markdown on disk (no cloud, no Logseq API). Karpathy LLM-Wiki…
Install
$
uvx matryca-plumber statusClaude Code
claude mcp add matryca-plumber -- uvx matryca-plumber statusCursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"matryca-plumber": {
"command": "uvx",
"args": [
"matryca-plumber",
"status"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Matryca Plumber
I gave an AI agent access to my notes. It corrupted them. I built Matryca Plumber so that never happens again.
We are not building another "agentic memory"...
We are building the governed memory plane for humans and agents.
Human-owned memory. Agent-native access. Governed evolution.
Matryca Plumber does not define or require a graph database, vector database, embedding model or retrieval algorithm.
v2.0.0 is stable and available now. Matryca Plumber's default-on external Shadow DB, Strict Read Only protection, Markdown authority, and fail-closed fallback contract are now published on GitHub Releases and PyPI. Read the release record and changelog for the exact scope and upgrade notes.
Published maintenance prerelease:
v2.0.1-rc.1remains available for opt-in evaluation as an exact historical artifact. It adds a bounded, canonicaljournal_dayhandler that reads Markdown directly without querying Shadow or mutating a graph, alongside provider-free evidence tooling. Stablev2.0.0remains the default recommendation. The current development branch has advanced beyond that prerelease, so any later candidate or stable release requires its own exact-source qualification. See the release record and historical qualification plan.
RC2 terminal history; RC3 published; RC4 preparation:
v2.0.1-rc.2failed before GitHub Release creation and PyPI publication; its signed tag and workflow evidence are immutable but are not a public artifact, Gate B result, or stable-promotion credit.v2.0.1-rc.3is a published historical prerelease.v2.0.1-rc.4/2.0.1rc4remains unpublished. An earlier exact candidate (74884c38) has source, build, and installed-resource evidence, but later changes require a new current-source selection and qualification. No RC4 tag, public artifact, Gate B result, or stable promotion exists. See the RC2 failed-publication record, RC3 publication record, and RC4 preparation and qualification plan.
Local-first human/agentic memory inspired from Logseq OG and maintenance for Logseq. Matryca Plumber gives humans and agents one safe, structured interface to a Markdown knowledge graph—without turning an opaque database or a model provider into the owner of that knowledge.
Video Overview: Watch this to learn how Matryca Plumber works, how it connects to the wider Matryca ecosystem, and where it fits in shared human/agentic memory.
Quick start · Why Matryca · Memory model · Architecture · Shadow DB · v2.0.0 release · Agent guide · Documentation
Quick start
Requires Python 3.12 or newer and a Logseq OG graph.
# Run the UI without installing anything permanently
uvx matryca-plumber status
Open http://127.0.0.1:8500, select a cloned Logseq graph, review the pre-flight checks, and start the engine when ready.
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io