post-cortex

Intelligent conversation memory system for AI assistants — persistent knowledge storage, semantic search, knowledge graph, MCP + gRPC transports.

This is the facade meta-crate: one dependency line for the whole post-cortex stack. Direct dependence on a single member crate is usually preferable for production deployments (smaller compile time, fewer transitive deps).

Picking the right crate

Goal	Crate
Domain types, traits, error	`post-cortex-core`
gRPC client (no server)	`post-cortex-proto`
Custom storage backend	`post-cortex-storage`
Embedding engine + HNSW	`post-cortex-embeddings`
Full memory orchestrator	`post-cortex-memory`
MCP tool functions	`post-cortex-mcp`
Running daemon + `pcx` CLI	`post-cortex-daemon`

Install

[dependencies]
post-cortex = "0.2"

Example

use post_cortex::{ConversationMemorySystem, SystemConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let system = ConversationMemorySystem::new(SystemConfig::default()).await?;
    let session = system.create_session(None, None).await?;
    println!("created session {session}");
    Ok(())
}

Features

Feature	Default	What it enables
`embeddings`	yes	BERT + HNSW via `post-cortex-embeddings`
`surrealdb-storage`	no	SurrealDB backend
`surrealdb-tikv`	no	SurrealDB + TiKV distributed KV
`otel`	no	OpenTelemetry exporter wiring

Architecture

post-cortex            (this facade)
├── post-cortex-core         (domain — no I/O)
├── post-cortex-proto        (gRPC wire types)
├── post-cortex-embeddings   (BERT + HNSW)
├── post-cortex-storage      (RocksDB + SurrealDB)
├── post-cortex-memory       (orchestrator)
├── post-cortex-mcp          (MCP tools, pure lib)
└── post-cortex-daemon       (rmcp + axum + tonic + pcx CLI)

Lock-free design (DashMap, ArcSwap, atomic ops, actor pattern) throughout the storage + session layers — see post-cortex-core for the lock-free invariants.

MSRV

Rust 1.85 (edition 2024).

License

MIT — see LICENSE.

post-cortex 0.3.1