# Aionis Docs > Aionis is an execution memory runtime for AI agents. It governs memory admission, compresses long execution history into state-preserving context, records memory influence, supports controlled forgetting and rehydration, and exposes SDK/API/MCP integration paths. ## Primary URLs - Website: https://www.aionis.work - Docs: https://docs.aionis.work - GitHub: https://github.com/ostinatocc/Aionis ## Core product concepts - Execution Memory: plans, decisions, failed branches, validation results, handoffs, and active routes represented as governed state. - Memory Firewall: external or internal memory candidates must pass admission before entering an agent prompt. - Agent Flight Recorder: trace what memory was surfaced, suppressed, used, and linked to outcomes. - State-Preserving Context Compression: reduce long execution history while preserving active state, blocked branches, procedure memory, rehydrate pointers, and auditability. - Admission Dataset Export: turn guide decisions and feedback attribution into data for memory policy evaluation. ## Recommended reading order - Start with /get-started/quickstart. - Then read /products/execution-memory and /concepts/admission. - For external memory stacks, read /using-aionis/govern-external-memory and /integrations/external-memory. - For MCP clients, read /integrations/mcp. ## Documentation index ### Intro - [Aionis Docs](https://docs.aionis.work): Documentation for the Aionis execution memory runtime. ### Get Started - [Get Started](https://docs.aionis.work/get-started): Install Aionis and choose the right integration path. - [Quickstart](https://docs.aionis.work/get-started/quickstart): Run the local Runtime and complete the first Aionis loop. - [Install Aionis](https://docs.aionis.work/get-started/install): Install the Runtime, SDK, MCP bridge, and Claude Code integration. - [Run the Runtime](https://docs.aionis.work/get-started/run-runtime): Start and verify the Aionis Runtime locally. - [First Agent Loop](https://docs.aionis.work/get-started/first-agent-loop): Use observe, guide, feedback, and measure in one loop. - [Choose an Integration](https://docs.aionis.work/get-started/choose-integration): Pick SDK, MCP, or HTTP integration for your agent host. - [Local Runtime Configuration](https://docs.aionis.work/get-started/lite-boundary): Understand the local-first Runtime boundary and configuration. ### Products - [Products](https://docs.aionis.work/products): Aionis product surfaces for execution memory, firewalling, and audit. - [Execution Memory](https://docs.aionis.work/products/execution-memory): Use Aionis to preserve plans, decisions, branches, and validation state. - [Memory Firewall](https://docs.aionis.work/products/memory-firewall): Govern external and internal memory before it can influence an agent. - [Agent Flight Recorder](https://docs.aionis.work/products/flight-recorder): Replay what memory the agent saw, used, suppressed, and why. - [Loop Engineering](https://docs.aionis.work/products/loop-engineering): Use Aionis as the memory and governance layer for agent loops. - [Plan as Memory Asset](https://docs.aionis.work/products/plan-as-memory-asset): Turn plans, decisions, and acceptance checks into reusable execution memory. - [Controlled Forgetting](https://docs.aionis.work/products/forgetting): Suppress, expire, archive, and rehydrate memory with traceable policy. - [Admission Dataset Export](https://docs.aionis.work/products/admission-dataset-export): Export memory admission records for policy evaluation and improvement. ### Core Concepts - [Core Concepts](https://docs.aionis.work/concepts): Understand Aionis state, admission, feedback, and memory types. - [State Model](https://docs.aionis.work/concepts/state): How Aionis models current, stale, contested, archived, and active state. - [Admission Surfaces](https://docs.aionis.work/concepts/admission): Understand use_now, inspect_before_use, do_not_use, and rehydrate. - [Feedback Attribution](https://docs.aionis.work/concepts/feedback): Connect memory exposure and agent behavior to outcomes. - [Ordinary vs Execution Memory](https://docs.aionis.work/concepts/ordinary-vs-execution): Separate preference and fact memory from executable agent state. ### Using Aionis - [Using Aionis](https://docs.aionis.work/using-aionis): Operate Aionis through observe, guide, feedback, measure, and rehydrate. - [Observe Execution](https://docs.aionis.work/using-aionis/observe-execution): Write execution events, decisions, branches, and outcomes into Aionis. - [Guide an Agent](https://docs.aionis.work/using-aionis/guide-agent): Compile governed memory into agent-facing context. - [Send Feedback](https://docs.aionis.work/using-aionis/feedback): Attribute outcomes to memory decisions and agent usage. - [Measure Effect](https://docs.aionis.work/using-aionis/measure): Measure whether memory improved, harmed, or had no effect. - [Snapshot & Replay](https://docs.aionis.work/using-aionis/snapshot-replay): Inspect operator snapshots and replay memory influence. - [Rehydrate Evidence](https://docs.aionis.work/using-aionis/rehydrate): Restore raw evidence only when compact context is not enough. - [Forget & Suppress](https://docs.aionis.work/using-aionis/forget): Control when memory should be hidden, archived, or blocked. - [Govern External Memory](https://docs.aionis.work/using-aionis/govern-external-memory): Apply Aionis admission governance to external memory candidates. ### Integrations - [Integrations](https://docs.aionis.work/integrations): Connect Aionis with SDK, MCP, HTTP, and multi-agent hosts. - [TypeScript SDK](https://docs.aionis.work/integrations/sdk): Use the Aionis TypeScript SDK in your agent loop. - [Claude Code](https://docs.aionis.work/integrations/claude-code): Install the Aionis Claude Code plugin for lifecycle hooks and MCP tools. - [MCP](https://docs.aionis.work/integrations/mcp): Connect Cursor, Zcode, and MCP clients to Aionis. - [Raw HTTP](https://docs.aionis.work/integrations/http): Call the Aionis Runtime directly over HTTP. - [Multi-Agent Hosts](https://docs.aionis.work/integrations/multi-agent): Share governed execution memory across planner, worker, verifier, and reviewer agents. - [External Memory](https://docs.aionis.work/integrations/external-memory): Use Aionis in front of Mem0, Zep, vector databases, logs, and internal stores. ### Operations - [Operations](https://docs.aionis.work/operations): Configure embeddings, storage, security, and troubleshooting. - [Configuration](https://docs.aionis.work/operations/configuration): Runtime environment variables and operating modes. - [Embeddings](https://docs.aionis.work/operations/embeddings): Configure embedding providers and recall behavior. - [Storage & Scale](https://docs.aionis.work/operations/storage-scale): Understand local storage, recall, and scale boundaries. - [Security Configuration](https://docs.aionis.work/operations/security-boundary): Understand the local Runtime security boundary and deployment posture. - [Troubleshooting](https://docs.aionis.work/operations/troubleshooting): Fix common install, runtime, embedding, and integration issues. ### API Reference - [API Reference](https://docs.aionis.work/api): HTTP API overview for the Aionis Runtime. - [Observe / Guide / Feedback](https://docs.aionis.work/api/observe-guide-feedback): Core product loop API for memory observation, context compilation, and feedback. - [Measure / Snapshot](https://docs.aionis.work/api/measure-snapshot): Measure memory effect and inspect operator snapshots. - [Memory Govern](https://docs.aionis.work/api/memory-govern): Govern internal or external memory candidates through Aionis admission surfaces. - [Flight Recorder](https://docs.aionis.work/api/flight-recorder): Retrieve memory decision traces and replayable audit records. - [Rehydrate](https://docs.aionis.work/api/rehydrate): Fetch raw evidence referenced by compact guide context. - [Forget](https://docs.aionis.work/api/forget): Suppress, archive, or forget memory through the Runtime API. ### Examples - [Examples & Proof](https://docs.aionis.work/examples): Examples, demos, and evidence links for Aionis behavior. ### Migration - [Migration](https://docs.aionis.work/migration): Move from recall-only memory to governed memory admission. - [Use Aionis with Mem0](https://docs.aionis.work/migration/mem0): Keep Mem0 retrieval while adding Aionis memory governance. - [Use Aionis with Zep](https://docs.aionis.work/migration/zep): Keep Zep retrieval while adding Aionis memory governance. - [From Recall to Governed Memory](https://docs.aionis.work/migration/recall-to-governed): Upgrade from relevance-only recall to memory admission. ### Changelog - [Changelog](https://docs.aionis.work/changelog): Release notes for Aionis Runtime, SDK, MCP, and docs.