Skip to main content
Use this page to recognize common unavailable states in Traycer Desktop.

​
Host Status

For the Host mental model, see Hosts. For Host controls, see Settings > Host.
StateMeaning
RunningThe host is running and reachable.
StoppedThe host is installed, but the process is not running.
Not installedThe host is not installed for this channel.
Registry unreachableTraycer could not reach the host registry.
Update check unavailableTraycer could not check for host updates.
If Desktop shows Starting local host… for too long, use the retry action or open Settings > Host.

​
Report An Issue

Use Report Issue when you want to send a bug report with desktop and host details attached. To open it:
  1. Open the desktop Help menu.
  2. Select Report Issue.
  3. Fill in the title, what happened, steps to reproduce, expected behavior, and actual behavior.
  4. Select Submit Report. Traycer uploads the report privately and opens a pre-filled GitHub issue.
You can also open Report Issue from the command palette. If an app-update error appears, its toast can include a Report Issue button that opens the same dialog.

​
Open Logs

Use logs when an issue involves startup, host status, updates, provider setup, terminal sessions, or other desktop/host behavior. To open logs from the app:
  1. Open the desktop Help menu.
  2. Select Open Logs.
  3. In the Open Logs dialog, expand a log entry to preview recent output.
  4. Select Reveal to open the selected log file in your file manager.
You can also open logs from the Traycer tray menu with Open Logs. The tray path opens Settings → Host and the logs dialog. From a terminal, use: 
traycer host logs --tail 200
Use traycer host logs --follow to stream new host log lines.

​
Provider Auth

Provider setup states can include:
StateMeaning
Checking accountTraycer is checking provider/account availability.
Not authenticatedThe provider needs login, API key, or CLI auth.
API key setA required key is configured.
Account status unavailableTraycer could not confirm provider status.
For Cursor, add the Cursor API key in Settings → Providers or export CURSOR_API_KEY in the environment used by the host.

​
Terminal and Host-Bound Tabs

For why tabs bind to a Host, see Hosts.
MessageMeaning
Host "{label}" is unreachable. This terminal is permanently closed.The terminal or terminal-agent PTY cannot move to another host. Close the tab and start a new session when the host is unavailable.
Bound host "{label}" is offline. Continue this thread on the active host?A chat can continue by cloning the thread onto the Current Host.
This file is on host "{label}", which is currently unreachable.A file preview cannot load until the host comes back.
This file is on host "{label}". Switch your active host to "{label}" to view it.The file is reachable, but not through the Current Host.
This diff is on host "{label}", which is currently unreachable.A diff cannot load until the host comes back.
The important distinction: chats can clone to another host; terminal sessions cannot migrate.

​
Worktree Setup

Agent worktree setup can show states such as:
StateMeaning
Creating worktreeTraycer is creating the worktree for the run.
Setting up worktreeSetup is still running.
Worktree readyThe worktree is ready.
Setup failedSetup failed before the first message could run.
Setup cancelledSetup was cancelled.
Worktree setup incompleteThe run cannot continue until setup is resolved.
If a workspace folder no longer exists or became unreachable, choose an available workspace folder and retry the run.

​
Model Picker

StateMeaning
Loading modelsTraycer is loading available model options.
Couldn’t load providersProvider list failed to load.
Couldn’t load modelsModel list failed to load for the selected provider.
No models availableThe selected provider returned no usable models.
No models matchSearch/filtering removed all model choices.
Connect Cursor / Add API keyCursor needs a configured API key before use.
If a provider is missing from the picker, it may be unavailable, not installed, or not configured.