Skip to Content
Aionis v0.3.2 is the current Runtime baseline for SDK/API hosts, MCP clients, plugins, Substrate-backed recall, and self-managed agent loops.
Intro

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 -> snapshot

Start 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 setup

The 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 -> snapshot

For 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 user

Then start context-first:

aionis_context -> Agent action -> aionis_record_step -> aionis_flight_recorder

For 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:onboard

What Aionis Gives You

Product surfaceWhat it gives your Agent
Execution MemoryAccepted route, validation evidence, handoff state, and reusable procedures across sessions.
Context Compileruse_now, inspect_before_use, do_not_use, and rehydrate surfaces instead of raw history dumps.
Ordinary Memory RecallAnswerable facts, source spans, entities, aliases, and Substrate-backed recall for factual context.
Memory FirewallGoverned admission for Mem0, Zep, Supermemory, vector DBs, markdown, logs, and custom memory stores.
Flight RecorderReplay what memory the Agent could see, what was blocked, and why.
Feedback AttributionA closed loop from admitted memory to actual outcome.
SubstrateDurable evidence sidecar for backup, audit, migration, preview context, and stronger ordinary-memory recall.
Trace-to-Skill CandidatesMeasured 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

SurfaceUse
Execution MemoryPrimary surface. Continue long-running work with the accepted route, action boundary, procedures, and rehydrate pointers instead of full history.
Memory FirewallFast adoption path. Govern memory candidates from Mem0, Zep, vector DBs, markdown, or custom backends before prompt use.
Agent Flight RecorderAudit surface. Replay what an Agent could see, what was blocked, and why.
Loop EngineeringGive plan/change/observe/revise loops memory, feedback attribution, and measurement.
Controlled ForgettingSuppress, archive, unsuppress, or delete memory with traceable lifecycle state.
Admission Dataset ExportExport 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 pathWhat it shows
MGBenchPublic memory-governance scenarios for active state, stale state, rehydrate, scope, and audit coverage.
MemoryData 50-sample replaySubstrate-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

  1. Your host calls observe when the Agent attempts work, sees tool output, gets verifier feedback, or finishes a handoff.
  2. Your host calls guide before the next Agent turn.
  3. Aionis compiles governed context: current path, inspect-only evidence, governed alternatives, procedures, and rehydrate pointers.
  4. The Agent acts in your host.
  5. Your host sends feedback tied to the guide trace.
  6. Aionis can measure effect and expose a snapshot for replay.

Start Here

GoalNext page
Install and run the RuntimeGet Started
Connect SDK, HTTP, MCP, or AIFS to an AgentConnect an Agent
Configure the complete local stackFull Setup
Call product endpointsAPI Reference
Connect SDK, HTTP, MCP, AIFS, plugin, or external memoryIntegrations
Review the benchmark surfaceMGBench
Track public docs changesChangelog
Last updated on