omnigent-plur 0.1.0

PLUR persistent memory for OmniGent agents — auto-recall + auto-learn, wrapping the PLUR MCP server.

omnigent-plur

Persistent memory for OmniGent agents, powered by PLUR. OmniGent governs and composes agents but has no memory; omnigent-plur plugs PLUR in so an agent corrected on Monday remembers on Tuesday — across sessions and harnesses.

Status: v0 / alpha. Validated on real infrastructure: the agent-driven MCP path and the auto-learn policy run on stock OmniGent; auto-recall uses the upstream context_providers hook (proven end-to-end with a live model). See DESIGN.md.

How it works

It wraps PLUR (never reimplements it): all memory goes through the published plur-mcp stdio server over MCP. Three layers, via OmniGent's own extension seams:

1. Agent-driven (stock OmniGent) — declare PLUR as an MCP tool; the agent calls recall/learn.
2. Auto-learn (stock OmniGent) — a request-phase policy captures corrections automatically.
3. Auto-recall (needs the context_providers hook) — a per-turn provider injects recalled engrams into the system prompt, additively.

Install

pip install omnigent-plur            # once published
# from source:
pip install -e ".[dev]"

Requires the PLUR MCP server on PATH (plur-mcp, from @plur-ai/mcp). Auto-recall requires an OmniGent build with the context_providers hook.

Quickstart

omnigent run examples/plur_agent.yaml -p "fix the deploy script"

Pieces

File	Role
omnigent_plur/plur_client.py	The only code that talks to PLUR (plur-mcp over MCP).
omnigent_plur/policy.py	plur_autolearn — request-phase auto-learn policy.
omnigent_plur/providers.py	recall — per-turn auto-recall context provider.
examples/plur_agent.yaml	Working agent spec wiring all three layers.

Develop

pip install -e ".[dev]"
ruff check . && ruff format --check . && pytest -q

Apache-2.0.