Cannot finish onboarding

Complete the Global Agent step: valid OpenRouter key + successful check.
Cancel or finish any in-flight YouTube OAuth before the optional step can complete (or skip YouTube).
If you are stuck after an update, try Settings → General → Replay onboarding once login works.

Confirm GitHub or Google is allowed for your Bitslix account.
Check that the system browser completes OAuth and returns to blxade://auth/callback.
Corporate proxies or blocked deep links can interrupt desktop OAuth.
If offline without a valid lease, you must come online for a fresh lease.

“No license” / access denied

Lifetime license may be missing, revoked, or the lease expired offline.
Sign in online to refresh the lease.
Local development bypass is debug-only and not available in release builds.

Global Agent errors

Re-test OpenRouter under Settings → Connections.
Ensure the selected model supports tools.
Re-import the key if you rotated it on the provider side.
Network blocks to OpenRouter will fail the connection check.

Settings → Shells / Agents → Rescan
Confirm the executable is installed and on PATH (or a standard install location).
Enable the toggle if the entry is discovered but disabled.

Terminal looks wrong in Light theme

Enable or disable dim terminals in Light mode under Appearance. Restart a terminal node if an embedded TUI cached old colors (new spawns pick up theme env).

Music will not connect

Open Settings → Connections → YouTube
Complete OAuth; add your Google account as a test user if the OAuth client is in testing mode
Replay onboarding or Danger Zone actions may have disconnected YouTube — reconnect

Voice / microphone

Grant OS microphone permission
Pick the correct device under Voice → Microphone and run the test
Install local models if using on-device STT
Provide OpenAI/xAI keys for Realtime modes

Canvas did not save

On switch/close, choose Retry if prompted
Check disk permissions on the project folder
Increase autosave delay only if you are mid-edit; do not force-kill the app during flush

Loops not running

BLXAde must stay open
Profile must be eligible (agent installed, not disabled)
Check the Loops node for skipped/error occurrences and interval
After moving a project folder, use rebind if the catalog warns

Logs and support details

Settings → Logs: enable file logging, open the log folder, share only redacted logs
Prefer stable error codes from the UI over raw API dumps
Version/OS info is under Settings → About

Access closed / everything suspended

If the license lease expires or is denied, productive runtimes suspend (PTYs, Loops, Voice, Hermes, previews). Sign in online to refresh access; killed processes are not auto-restored. See Security.

Notifications missing deep link

If a notification targets a workspace that is not open or no longer recent, the event stays in the inbox with a warning. Reopen the project manually, then use the link again. See Notifications.

Reset without losing projects

Safe-ish steps:

Clear recents / session restore (Danger Zone)
Replay onboarding
Disconnect and reconnect providers
Remove and reinstall agent MCP/hooks for one CLI

Avoid deleting the project folder unless you intend to destroy the workspace.

Troubleshooting