Skip to content
AlphaBase
HomeDocs

Troubleshooting

Runtime and UI issue diagnosis across Desktop, VS Code, CLI, and Web.

Start by validating runtime health first, then app-layer behavior.

Quick Health Commands

Terminal window
curl http://127.0.0.1:4096/runtime/health
curl http://127.0.0.1:4096/runtime/capabilities

Common Failures

Unauthorized (401)

Likely auth mismatch between client and runtime.

Checks:

  1. confirm host/port target
  2. verify ALPHABASE_SERVER_PASSWORD and client credentials
  3. refresh diagnostics and retry

Task stops without final completion response

Checks:

  1. inspect runtime logs in failure window
  2. verify tool failure paths emit terminal/handover state
  3. confirm stream completion event reached client

Output appears malformed in response area

Checks:

  1. confirm write/edit tool completed
  2. verify artifact block parsing did not degrade to plain text
  3. retry with minimal deterministic prompt

Diagnostics panel shows unavailable capabilities

Checks:

  1. refresh capabilities
  2. verify provider credentials and upstream reachability
  3. verify local dependencies (for local AI paths)

Log Locations

  • macOS/Linux: ~/.local/share/alphabase/log/
  • Windows: %USERPROFILE%\\.local\\share\\alphabase\\log