Troubleshooting

Reconnecting Linear

If tAI says Linear is not connected, or access stops working mid-conversation, most often the cause is that access was revoked from Linear's side rather than from tAI. To reconnect:

1. Open Settings → Connectors.
2. Find Linear and click Disconnect if it shows as connected.
3. Click Connect and complete Linear sign-in again.

Other issues

• linear_create_issue or linear_create_project keeps failing. The workspace likely has more than one team. Specify one by name or key, get the list from linear_list_teams.
• linear_upload_attachment can't find my file. The sandbox path must match a file already in that conversation's sandbox, written by tAI or uploaded earlier in it.
• linear_search_issues isn't finding an issue I know exists. Search matches against the title. Use a specific word likely to appear there rather than a vague description.
• linear_assign_issue or linear_update_issue_status keeps failing. The assignee or status name needs to match exactly what Linear lists as available; the error message on a failed call includes the valid options to retry with.