Skip to Content
Aionis currently ships as a local-first Lite Runtime for developer machines and self-managed deployments.
OperationsTroubleshooting

Troubleshooting

Runtime Cannot Recall Anything

Check:

  • EMBEDDING_PROVIDER
  • provider API key
  • network access to the provider
  • matching scope between writes and guide calls

Guide Context Looks Empty

Make sure the observe and guide calls share:

  • tenant,
  • scope,
  • task signature,
  • role or team identity where relevant.

Feedback Is Rejected

Feedback attribution is strict. Aionis expects memory IDs that were exposed by the guide trace. Do not attribute arbitrary memory IDs after the fact.

For Nextra docs pages, do not mark the root Intro page as type: "page". That turns it into a top-level page and hides the docs sidebar. The Aionis docs root should remain a normal document page.

MCP Client Sees No Tools

Confirm the MCP bridge points to the running Runtime:

npx @aionis/mcp@latest --base-url http://127.0.0.1:3001 --scope my-project
Security BoundaryOverview