Aionforge Memory

Long-term memory for AI agents, built on selene-db.

> Status: 0.3.0 public release. Aionforge Memory is public and usable, > but still pre-1.0. Expect schema and API changes before 1.0. The 0.3.0 > release is a fresh-store release from 0.2.x because the selene-db 1.2 to 1.3 > upgrade changes the WAL/schema format.

Aionforge Memory gives agents a durable memory store they can recall across sessions. It stores captured episodes, derived facts and notes, procedural memory, work items, provenance, and audit events in selene-db, then recalls relevant context with lexical search, vector search, graph signals, recency, importance, and trust-aware ranking.

Use it when you want an agent or a team of agents to remember decisions, handoffs, failures, procedures, project facts, and open work without treating recalled text as new instructions.

Quick Start

These commands build the local binary and start an MCP server on loopback. Embedding is disabled in this first config so you can verify the server without running an OpenAI-compatible embedding provider.

cargo build --locked --release -p aionforge-cli

mkdir -p .aionforge
cat > .aionforge/config.toml (embedder: E) -> Result> {
let now = "2026-06-06T09:30:00-05:00[America/Chicago]".parse()?;
let memory = Memory::open_in_memory(embedder, &now, MemoryConfig::default())?;

let viewer = Principal::agent("0197b0aa-3c5e-8000-8000-000000000001".parse()?);
let bundle = memory.search(RecallQuery::new("graph databases", viewer, 5)).await?;
println!("{}", bundle.rendered);
# Ok(())
# }

For complete call shapes, see [crates/aionforge/src/lib.rs](crates/aionforge/src/lib.rs) and the integration tests under [crates/aionforge/tests](crates/aionforge/tests).

Documentation

Start here:

• [Getting started](docs/getting-started.md) - build, configure, validate, and run.
• [Data model and mental model](docs/data-model.md) - what gets stored and recalled.
• [Embedding guide](docs/embedding-guide.md) - providers, dimensions, and secrets.
• [MCP client support](docs/mcp-clients.md) - Codex, Claude Code, OpenCode, Cursor.
• [Agent plugin](docs/plugins.md) - skills, identity, and client notes.
• [Security model](docs/security-model.md) - namespaces, untrusted recall, signing.
• [Operations and recovery](docs/operations-recovery.md) - production setup and WAL recovery.
• [Honest scope](docs/honest-scope.md) - what is shipped, experimental, or deferred.

The full subsystem map is in [docs/README.md](docs/README.md).

Contributing

This project is public and pre-1.0. Issues and pull requests are welcome. Open an issue before large design changes.

• [CONTRIBUTING.md](CONTRIBUTING.md) covers setup, branch flow, commit style, and local gates.
• [AGENTS.md](AGENTS.md) covers crate layering, invariants, and agent-facing validation.
• Use the [issue chooser](../../issues/new/choose) for bugs, features, and design proposals.

Do not include private planning notes, secrets, internal handoff text, or agent transcripts in public issues or PRs.

License

Dual-licensed under either [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT), at your option. Contributions are accepted under the same dual license unless stated otherwise.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jscott3201
• Source: jscott3201/aionforge-memory
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.