elph-core

Shared foundation for Elph applications. Provides filesystem helpers, default home-directory scaffold files (BundledManifest, TrustStore, VersionFile), structured logging, config/data path resolution utilities, and the memz agent memory module.

Memory

Elph memory memz is a Turso-backed agent memory store: semantic retrieval, per-memory weight scoring, and task-scoped lifecycle tracking. Memories persist across sessions so agents can reuse lessons from past work.

use elph_core::memz::{MemzConfig, create_memory_store, create_fastembed, FastEmbedOptions};

let config = MemzConfig::new("/path/to/memory.db", "session-id");
let embed = create_fastembed(FastEmbedOptions::default())?; // requires `fastembed`
let store = create_memory_store(config, embed);

store.init().await?;
let result = store.start_task("implement auth middleware").await?;
// result.memories — top-k relevant memories for this task

Feature: fastembed — local embeddings via fastembed (all-MiniLM-L6-v2, 384 dims). Without it, supply your own EmbedFn.

Paths: Elph stores project memory at PROJECT_DIR/.elph/memory.db. Standalone use defaults to ./.memz/memory.db (MEMZ_DIR).

Full documentation: docs/memory.md.

Third-party attribution

The memz module is ported from memelord (packages/sdk). The original code is licensed under the MIT License. Copyright (c) 2026 Glauber Costa.

License

Licensed under the MIT License.