Repository navigation
Troubleshooting
Run cascade doctor. Confirm credentials, selected deployment/model, required endpoint URL and network connectivity. An Azure deployment name is not necessarily the same as the public model ID. Check the configured tier using /model and /models; inspect the router's decision with /why.
Ollama: verify that Ollama is running, that the model is pulled, and that the configured endpoint (often localhost:11434) is reachable from the machine running Cascade.
Check /budget, /cost, and /why. Cost/token caps can stop further work while reserving funds for the final answer; the task may legitimately report partial completion. A manually pinned tier model is not automatically replaced just to save money. Use /continue where a checkpoint is resumable.
Look for pending plan review, dangerous tool confirmation, escalation or connector authorization. An interactive UI can wait for a human; the OpenAI-compatible HTTP adapter is noninteractive and uses unattended defaults.
Configure GitHub or Google OAuth with the correct callback and origin. CLOUD_DEV_BYPASS=1 works for loopback-only testing but must never be published on a network. See Cloud-and-Self-Hosting.
Confirm a persistent storage volume is mounted at DATA_DIR. Container-only SQLite/uploads can be lost when the container is replaced. Back up surviving data before attempting repairs.
Remote browser access requires server-configured CDP or Steel settings. Check operator environment variables, correct WebSocket/API URL, credentials, quota and container networking. Do not solve a connection problem by exposing a private CDP control socket publicly.
A .docx, .pptx or .xlsx requires valid binary rendering. Use generate_document or the hosted browser's exported document renderer, not a plain text write with a renamed extension.
Include the OS, surface (CLI/desktop/web), version/commit, provider, exact reproduction steps and redacted logs. Report issues using GitHub issue templates. Security defects must use the private reporting route in Security-and-Privacy.