egregore — kernel bridge to Egregore mechanics
Python-backed skill. The module is installed into the kernel venv; call the
functions directly instead of grepping bin/ scripts to reconstruct CLI usage:
import egregore
egregore.search("pricing decision") # ranked shared-memory recall
egregore.activity() # team activity JSON
egregore.handoff(to="renc", topic="...", body="...")
egregore.save(message="Save: topic", topic="topic")
egregore.branch("new topic") # task branch + worktree
egregore.notify_plan(recipient="renc", message="...") # proposal ONLY
Ground rules:
- Every function shells out to the corresponding
bin/script with a generous internal timeout and returns its text output.bin/stays the single mechanics layer — this module contains no logic of its own. notify_planonly CREATES a notification plan. Approval and dispatch remain subject to the explicit human Send / Edit / Cancel checkpoint: show the plan, get the user's approval, then runbin/notify.sh approve/dispatchwith the plan's one-use approval token. Never call approve or dispatch without a fresh human yes in this conversation.- Functions raise
RuntimeErrorwith the script's stderr on failure — report the single relevant line, do not debug the plumbing mid-workflow. help()on the module or any function shows signatures and semantics.