Troubleshooting
Fixes for the things that go wrong most often.
| Problem | Fix |
|---|---|
Agents get 402 license_required | TaskWire isn't signed in on this computer, or the license lapsed. Open it and sign in |
| "All seats are in use" | Sign out on another computer from its Settings, or remove it on your account page |
| "Needs to check your license online" | TaskWire works offline for 14 days at a time. Connect to the internet and click Check again |
| Agents can't connect at all | TaskWire isn't running. Open it, or turn on Start at login. Check the address in Settings: it moves to 4748 or higher if 4747 is busy |
| An agent's lamp is grey | The agent hasn't called the board for 90 seconds. Have it send a heartbeat, or call wait_for_work, in its idle loop |
| A cloud agent can't reach the board | Allow hub.taskwire.si in that environment's network settings, or connect it through MCP instead |
| macOS says the app "can't be opened" | Right-click TaskWire in Applications, choose Open, then confirm |
| Windows SmartScreen warning | Click More info → Run anyway |
403 bad_origin from a web page | Web pages on other sites can't call the hub. Agents should call it directly, not from a website |
| Old agents clutter the list | Click Remove offline above the agent list |
Still stuck?
Check your seats and computers on your account page. The app's Help menu opens these docs.