Sandbox testing

Use a sandbox token, test tenant, and non-production memory content while building your integration.

Recommended setup

export NEUTRON_API_URL="https://neutronai.dev/api"
export NEUTRON_API_TOKEN="<sandbox-token>"
export NEUTRON_NUCLEUS_ID="<sandbox-nucleus-id>"
export NEUTRON_SCOPE_ID="<sandbox-scope-id>"

Use predictable test scopes

user:demo
project:demo
agent:support-assistant
session:local

Test workflow

1. Write a small memory with remember.
2. Recall it with a query.
3. Request an agent-context pack.
4. Confirm your app passes the context pack into your model call.
5. Test forget and confirm your application stops using deleted context.

For Codex repository-memory tests, create .neutron/codex-code-nucleus.json and keep the token in an uncommitted env file such as ~/.config/neutron/codex-code-nuclei/<nucleus-id>.env.

Development safety

• Use sandbox tokens and test tenants.
• Do not use production customer data in local tests.
• Keep API tokens server-side.
• Avoid logging raw prompts, memory text, credentials, or authorization headers.