Troubleshooting

Debug the first-run path before debugging the agent.

Most Bilinc setup issues are key, entitlement, environment, or client configuration problems.

Install pathPyPI package
RuntimeHosted Cloud
InterfacePython + CLI + MCP
Releasev2.1.3
first.checks

Run the CLI health path first.

bilinc doctor
bilinc status
bilinc quicktest
common

Common setup problems have simple boundaries.

No API key

Run bilinc login or export BILINC_API_KEY before commit/recall.

Wrong module

Use python -m bilinc.cloud_mcp for the public Cloud adapter.

Expired trial

Move to Pro/Team or contact ReARC for Scale/Enterprise review.

agent.debug

Keep the agent prompt boring and explicit.

Tell the agent when to recall, when to commit, and that failed writes are not durable. Avoid asking the agent to guess whether memory was saved.