FAQ
Find the symptom, then check in order.
Sign-in and sessions
Section titled “Sign-in and sessions”| Symptom | Check first | Then |
|---|---|---|
| Signed out immediately after login | Cookies/local storage blocked | Try another browser or a private window |
| Left menu missing | Page finished loading | Refresh; contact the admin if it persists |
| Session list is empty | Switched accounts? | Create a new session |
| Spinner never stops | Is the selected model working? | Test it on the LLM page or switch the default |
Models
Section titled “Models”| Symptom | Cause | Fix |
|---|---|---|
| 401 / auth failure | Wrong, expired or mismatched key | Re-paste the key; check the protocol |
| Model not found | Typo or no permission | Verify the ID in the provider console |
| Reply truncated | Output limit too low | Raise max output tokens |
| Very slow | Model or network | Switch models; check the proxy |
| No quota shown | No quota URL configured | Provide a balance endpoint |
Tools and execution
Section titled “Tools and execution”| Symptom | Fix |
|---|---|
| Agent does not call a tool | Confirm the agent has it ticked |
| Command fails | Confirm the session has a sandbox and the image has the runtime |
| Command times out | Use background execution or raise the timeout |
| Output truncated | Expected; let the agent read the spilled file |
Sandbox
Section titled “Sandbox”| Symptom | Fix |
|---|---|
| Sandbox fails to start | Check URL/key, image and disk quota |
| Preview does not open | Listen on 0.0.0.0; correct port; preview domain resolves |
| Files vanish after restart | Discarding a sandbox loses files; download or commit them |
MCP and skills
Section titled “MCP and skills”| Symptom | Fix |
|---|---|
| MCP will not connect | Verify URL/command, headers, timeout; read the server error |
| No MCP tools | Refresh the tool list; confirm the server exposes tools |
| Skill not used | Make the trigger explicit in the description; tick it in the agent |
| Skill script errors | Check interpreter and dependencies in the sandbox image |
Data and security
Section titled “Data and security”Will my keys appear in the conversation? No. Credentials in Exchange Space are injected as env vars or files; the UI only shows masked values.
How do I export a session? Use the share/export entry in the session (per the current UI). Keep anything important in your own repository as well.
Can I recover a deleted session? Deletion is irreversible. Export first.
Still stuck
Section titled “Still stuck”Include three things and diagnosis gets much faster:
- The exact time (to the minute)
- The session link or name
- A screenshot plus what you expected