Execution Memory Runtime for AI Agents
Aionis gives long-running AI agents a shorter, cleaner, auditable execution context.
It is a memory Runtime for Agents that need to keep working across sessions, threads, roles, devices, model boundaries, and compaction boundaries without dragging the whole history forward.
Aionis records plans, decisions, outcomes, validation evidence, procedures, blocked alternatives, ordinary facts, and rehydrate pointers. Then it decides what is current, what needs inspection, what should stay blocked, and what must be expanded on demand before compiling the next Agent context.
observe -> guide -> agent action -> feedback -> measure -> snapshotStart With One Setup Command
The product path is Runtime first, then the integration surface that matches your Agent host: SDK, HTTP, MCP, AIFS, native plugin, multi-agent host contract, or Memory Firewall for external memory.
npx aionis setupThe guided setup installs a local Runtime, writes .env, and configures the
embedding provider used for stored-memory recall. Optional AIFS, Zvec ANN, and
native hook integrations can be added during setup.
For the shortest real Agent connection path after install, use Connect an Agent. It shows the SDK, HTTP, MCP, and AIFS options and the exact final context each path gives to the Agent.
The product loop is the same in every integration:
observe -> guide -> agent action -> feedback -> measure -> snapshotFor MCP-compatible coding Agents:
claude mcp add --transport stdio --scope project aionis -- \
npx -y @aionis/mcp@latest \
--base-url http://127.0.0.1:3001 \
--scope-from workspace \
--workspace-id-store userThen start context-first:
aionis_context -> Agent action -> aionis_record_step -> aionis_flight_recorderFor Claude Code sessions, install the plugin after the Runtime is running:
/plugin marketplace add https://github.com/ostinatocc/aionis-claude-code
/plugin install aionis@aionis-claude-code
/aionis:onboardWhat Aionis Gives You
| Product surface | What it gives your Agent |
|---|---|
| Execution Memory | Accepted route, validation evidence, handoff state, and reusable procedures across sessions. |
| Context Compiler | use_now, inspect_before_use, do_not_use, and rehydrate surfaces instead of raw history dumps. |
| Ordinary Memory Recall | Answerable facts, source spans, entities, aliases, and Substrate-backed recall for factual context. |
| Memory Firewall | Governed admission for Mem0, Zep, Supermemory, vector DBs, markdown, logs, and custom memory stores. |
| Flight Recorder | Replay what memory the Agent could see, what was blocked, and why. |
| Feedback Attribution | A closed loop from admitted memory to actual outcome. |
| Substrate | Durable evidence sidecar for backup, audit, migration, preview context, and stronger ordinary-memory recall. |
| Trace-to-Skill Candidates | Measured execution traces can become reviewable skill candidates without entering the prompt or mutating Runtime state. |
Aionis surrounds an Agent loop with governed execution memory. The Agent host plans, executes tools, validates work, and owns permissions. Aionis records evidence, governs what memory can influence the next turn, and explains every decision.
The Core Difference
Full history answers:
Pass everything to the model.Recall memory answers:
What memories are related to this query?Aionis answers:
Which memory state is allowed to affect this action right now?That difference matters when full history is too large, retrieved memory is
noisy, or old execution evidence and stale assumptions remain semantically
relevant. Aionis separates use_now, inspect_before_use, do_not_use, and
rehydrate so related history becomes governed state before it becomes
instruction.
Product Surfaces
| Surface | Use |
|---|---|
| Execution Memory | Primary surface. Continue long-running work with the accepted route, action boundary, procedures, and rehydrate pointers instead of full history. |
| Memory Firewall | Fast adoption path. Govern memory candidates from Mem0, Zep, vector DBs, markdown, or custom backends before prompt use. |
| Agent Flight Recorder | Audit surface. Replay what an Agent could see, what was blocked, and why. |
| Loop Engineering | Give plan/change/observe/revise loops memory, feedback attribution, and measurement. |
| Controlled Forgetting | Suppress, archive, unsuppress, or delete memory with traceable lifecycle state. |
| Admission Dataset Export | Export admission, usage, outcome, and feedback records for analysis and future learned policy. |
Execution Memory is the primary Runtime capability. Memory Firewall is the
fastest adoption path when you already have another memory backend.
Trace-to-Skill Candidates are the learning surface: Aionis can turn positive
continuity and workflow-reuse evidence into reviewable candidate assets through
trace -> feedback attribution -> measure -> candidate -> review -> promotion gate, while keeping them out of Agent prompts until normal admission and
promotion gates approve later use.
Invalidated-route handling remains part of the safety model: rejected or stale execution evidence stays governed. The headline is state-preserving, execution-ready context at lower context cost than full-history transfer.
Current Evidence
| Evidence path | What it shows |
|---|---|
| MGBench | Public memory-governance scenarios for active state, stale state, rehydrate, scope, and audit coverage. |
| MemoryData 50-sample replay | Substrate-backed ordinary-memory recall raised exact answer hits from 43/50 to 48/50 and evidence coverage from 47/50 to 50/50 in the v0.3 verification snapshot. |
| External Claude Code long-flow case | Two separate Claude Code sessions used published Aionis hooks with an isolated Runtime; Aionis carried governed execution context into the later session and recorded tool outcomes, validation evidence, handoff state, and post-run guide recovery. |
How It Works
- Your host calls
observewhen the Agent attempts work, sees tool output, gets verifier feedback, or finishes a handoff. - Your host calls
guidebefore the next Agent turn. - Aionis compiles governed context: current path, inspect-only evidence, governed alternatives, procedures, and rehydrate pointers.
- The Agent acts in your host.
- Your host sends
feedbacktied to the guide trace. - Aionis can
measureeffect and expose asnapshotfor replay.
Start Here
| Goal | Next page |
|---|---|
| Install and run the Runtime | Get Started |
| Connect SDK, HTTP, MCP, or AIFS to an Agent | Connect an Agent |
| Configure the complete local stack | Full Setup |
| Call product endpoints | API Reference |
| Connect SDK, HTTP, MCP, AIFS, plugin, or external memory | Integrations |
| Review the benchmark surface | MGBench |
| Track public docs changes | Changelog |