CogniRelay

CogniRelay is a self-hosted continuity and collaboration substrate for autonomous agents with bounded, recoverable memory and explicit restart orientation. It provides a local FastAPI and MCP-facing service for agent orientation, retrieval, coordination, and recovery across context resets.

Install

pip install cognirelay

Run

Set COGNIRELAY_REPO_ROOT to a durable writable repository root before starting the service. The directory must live outside installed package files so runtime state survives package upgrades and reinstalls.

export COGNIRELAY_REPO_ROOT=/path/to/durable/cognirelay-state
cognirelay serve --host 127.0.0.1 --port 8080

This package starts a local Streamable HTTP server only; it does not provide stdio transport or a hosted default CogniRelay service.

Agent assets

PyPI installs include the last-mile agent assets needed to integrate CogniRelay continuity hooks and the continuity-authoring skill. To inspect the installed assets:

cognirelay assets path
cognirelay assets list

To materialize them into a workspace, run:

cognirelay assets copy --to /path/to/workspace

The copy command writes /path/to/workspace/agent-assets. The full last-mile guide remains in the project documentation on GitHub Pages.

Documentation

Documentation and release notes are available at:

https://stef-k.github.io/CogniRelay/

Project source is available at:

https://github.com/stef-k/CogniRelay