Skip to main content

​
Desktop icon appears but no window opens

Confirm the process is running, then inspect the current Desktop log directory. On macOS:
A sidecar startup failure, secure-storage prompt, or incompatible credential database can prevent normal initialization. Do not delete the database before backing up sessions you need.

​
Stored credentials belong to another key

The database was copied from another OS-protected key or the Safe Storage identity changed. Restore the matching keychain/profile or start a fresh database and reconnect providers. Encrypted credentials cannot be recovered from the database alone.

​
No models are available

Open Settings → Providers and confirm a provider is connected. For Claude Code, run claude auth login. For OAuth providers, disconnect and start a fresh authorization flow.

​
Hosted MCP remains Needs Auth

Click Connect on a fieldless hosted OAuth card. Complete the browser flow and return to TurenOS. If no browser opens, inspect server logs for the redacted OAuth launch phase and verify your default browser.

​
A tool never starts

Look for a pending permission request. The selected agent, project location, external-directory policy, or tool-specific rule may deny execution.

​
Session points at a missing workspace

Reconnect or recreate the Git worktree, then open the session from the correct server location. Closing the tab does not repair or delete the durable session.

​
Linux credentials fail

Install and unlock a Secret Service provider such as GNOME Keyring or KWallet. TurenOS intentionally refuses plaintext credential fallback.

​
Get more evidence

Use the status UI, Desktop logs, forge --print-logs, and exact error text. Include platform, architecture, TurenOS version, and reproduction steps when filing an issue.