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.

Sidebar Disappears In Docs

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-from workspace \
  --workspace-id-store user