Plugins
Aionis connects to agent hosts, file-reading agents, SDK clients, MCP clients, and external memory backends. Pick the integration path based on how much control you have over the loop.
Choose A Path
TypeScript SDK
Use it when you control a Node or TypeScript Agent loop and want the full
observe -> guide -> feedback -> measure -> snapshot path.
Raw HTTP
Use it when your host is not TypeScript or you want language-neutral calls.
AIFS file surface
Use it when your agent reads workspace files more reliably than it calls tools.
AIFS mirrors governed guide context, active path, blocked memories, rehydrate
pointers, receipts, and snapshots into .aionis/.
MCP bridge
Use it when Cursor, Zcode, or another MCP client should talk to Aionis.
Claude Code plugin
Use it when you want Aionis context before prompts and execution evidence after tool use.
Multi-agent hosts
Use it when planner, worker, verifier, reviewer, or handoff roles share memory.
External memory
Use it when Aionis, Mem0, Zep, Supermemory, vector DBs, markdown, logs, or internal memory already produce candidates and Aionis should govern admission.
Core Contract
Every integration eventually maps onto the same product loop:
observe -> guide -> agent action -> feedback -> measure -> snapshotThe host owns execution. Aionis owns memory admission, context compilation, feedback attribution, measurement, and audit replay.
Integration Decision Tree
| Question | Recommendation |
|---|---|
| Do you control the Agent loop code? | Use the SDK. |
| Do you want Claude Code to use Aionis automatically? | Use the Claude Code plugin. |
| Should the Agent read Aionis through files in the workspace? | Use AIFS. |
| Do you want a zero-adapter trial in another MCP-capable coding Agent? | Use MCP. |
| Are you integrating from Python, Go, Rust, or a service boundary? | Use raw HTTP. |
| Do multiple Agents pass work across sessions? | Use the multi-agent host contract. |
| Do you already have a memory backend? | Keep it and add Memory Firewall through external candidates. |
Data You Should Preserve
Whichever path you choose, keep these fields stable:
| Field | Why |
|---|---|
tenant_id | Logical tenant boundary. |
scope | Project or workspace boundary. |
run_id | Execution session identity. |
task_signature | Stable workflow or task identity. |
agent_id | Agent that produced or consumed evidence. |
team_id | Shared lane for multi-agent memory. |
guide_trace_id | Feedback attribution key. |
Most failed integrations are not model failures. They are identity and scope mismatches.
Execution Responsibility
Aionis provides memory admission, context compilation, feedback attribution, and audit replay. Your host provides shell access, browser access, CI access, model calls, and tool execution.
Start with Quickstart, then pick the path above.