Account

Troubleshooting

⌃Space does nothing on the Mac. macOS uses it for "select previous input source". Free it under System Settings → Keyboard → Keyboard Shortcuts → Input Sources.

An assistant says it cannot delete a task. By design — agents only delete their own drafts. Delete accepted tasks yourself.

A connector will not connect. Check the URL ends in /mcp, and that you are pasting it as a custom connector, not as an API key. If a key is what your client wants, create one under Settings → Agents and send it as Authorization: Bearer pl_….

A task an agent created is not in my list. It is in Drafts. Use the Active filter, or a filter with Status: Draft, and accept it.

My files disappeared from a finished task. Files are deleted 48 hours after a task is marked done. Turn that off in Settings → Files; links are never affected.

The widget is empty. Open the app once so it syncs, and check the widget's list under long-press → Edit Widget — a filter that matches nothing shows nothing.

A list opens on the wrong filter. Lists open on the first filter in your order. Reorder them in Settings → Filters.

A task sent to a Mac route says Queued and nothing happens. No Mac is listening. On the Mac: Settings → Delegate Listener → switch it on, and keep Cotask running (it lives in the menu bar while listening). Queued work waits a day, then expires.

The Mac says Claude Code or Codex is not found, or signed out. Cotask looks in your login shell's PATH and the usual install folders; set the path by hand in Settings → Delegate Listener if yours is elsewhere. Sign in once in Terminal — claude auth login or codex login — then Check again.

My route's model list is empty. The Mac hasn't reported yet (listener off), or that CLI couldn't list its models. Type a model id instead — opus, gpt-6-sol — or leave it blank for the CLI's default.

A task sent to my Mac ran, but it is still in Doing. The listener doesn't complete tasks; the agent does, through the Cotask MCP server. Give the CLI that server in its own configuration — and note that a Read only route starts none. What the run said is in Settings → Delegate Listener → Recent runs, and its full output in the log beside it.

A delegated task shows "Delegated to …" on one device only. Who a task went to is remembered by the device that sent it; the other device shows the task in Doing. Scheduled sends are the exception.

An agent or a script gets 402. The account is on Free and the call sets something that is part of Pro — a reminder, a blocker, a note of completion — or the files are over 100 MB.

A parameter is refused. Its name contains a credential word — token, secret, password, key as in api_key… — even inside another word, like max_tokens. Rename it, or put the credential in the route's signing secret.