# Aionforge Memory

> A Rust-native agentic memory substrate built on the selene-db graph engine: a bi-temporal knowledge graph, hybrid retrieval, and an optional MCP server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-jscott3201-aionforge-memory`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jscott3201](https://agentstack.voostack.com/s/jscott3201)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [jscott3201](https://github.com/jscott3201)
- **Source:** https://github.com/jscott3201/aionforge-memory

## Install

```sh
agentstack add mcp-jscott3201-aionforge-memory
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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`](https://github.com/jscott3201/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.

```bash
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](https://github.com/jscott3201)
- **Source:** [jscott3201/aionforge-memory](https://github.com/jscott3201/aionforge-memory)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jscott3201-aionforge-memory
- Seller: https://agentstack.voostack.com/s/jscott3201
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.