Troubleshoot task providers

Task-provider availability is checked in a fixed order. Fix the first message you see, then re-check the source.

Availability states

HOST below is replaced by the selected host’s name.

State	Exact on-screen sentence	Fix
Host offline	HOST is offline. The full empty state says Reconnect this host to load tasks and make changes.	Start or reconnect that desktop or CLI host, or choose an online host.
Host too old	Update Glueprint on HOST to use task providers. The full empty state says This host does not support task providers.	Update Glueprint on the owning host, reconnect it, and re-check.
Plan	This feature requires a Pro plan or higher.	Use local access on the owning host or move to a plan that includes cross-host control. See Plans and limits.
Encryption locked	Unlock organization encryption and re-check.	Unlock the organization’s encrypted data in Glueprint, then click Re-check.
Client disconnected	Reconnect to HOST and re-check.	Restore the portal or desktop connection to the selected host, then re-check.
Rate limited	Status unavailable	Wait until the provider’s retry time when one is supplied, then use Re-check or Refresh.
Provider error	Status unavailable	Open Settings > Plugins for the provider’s detailed error, correct it, and re-check.

Other common messages are Choose a host to view tasks. when no host is selected and Connect this provider on HOST to view tasks. when the host has no usable provider credential.

What Status unavailable means

The compact source and linked-task rows use Status unavailable for both a provider rate limit and another provider error. It does not mean that the saved task link was removed.

Open Settings > Plugins and open the plugin to see its specific error. For a rate limit, wait before retrying. For an authentication or permission error, reconnect the credential or change provider access. A linked session remains openable from saved Glueprint data even while the provider status is unavailable.

Re-check and refresh

Settings automatically reads a host’s task-provider report once when you select that host. Later retries are explicit:

1. Open Settings > Plugins.
2. Choose the owning host.
3. Click Re-check.
4. Expand the affected provider and inspect its connection row.

Use Refresh in the Tasks view to refresh the first stage that needs it — the provider report, container list, or first task page. Use Retry for a failed task or comment page. If old task data is retained, the view says Showing last-known tasks. and disables changes until the source is usable.

Connection checks

Provider	Check
GitHub Issues	Open Settings > Git Forge on the owning host and confirm the GitHub account. Then return to Plugins and re-check.

Where credentials live

Credentials stay on the host that owns the connection. GitHub Issues uses the GitHub credential already managed by Git Forge on that host. The web portal does not store provider secrets and cannot edit them.

Remove or replace GitHub credentials in Settings > Git Forge on the owning host. On a CLI host, run glueprint forge token remove github.com to remove the GitHub credential.