Common errors

License

  • «License not found» — no key entered or wrong format. Format: POA-XXXX-XXXX-XXXX. Create a key in your account.
  • «Device limit reached» — the license already has 3 devices. Unlink an extra one in your account (the «Devices» section).
  • «Subscription expired» — renew; note the 3-day grace period after expiration.
  • «License server unreachable» — check your internet; the offline cache lasts 72 hours.

Network & providers

  • 401/403 from provider — wrong or exhausted API key. Check the key and your provider balance.
  • 429 (rate limit) — too many requests to the model. Wait or switch models.
  • Response timeout — long tasks can be interrupted; use «Continue» or lower max_tokens.

Agent

  • Agent is looping — the loop protection kicked in. Make the task more specific or split it into steps.
  • «Rejected by user» — you (or the approval policy) rejected an operation. Allow it or enable «Full access».
  • Command not found — the agent's environment is limited; for complex tools specify the full executable path.

Files

  • «Access denied» on file operations — the path is outside the workspace. Assign the right workspace (Ctrl+Shift+U).
  • Edit didn't apply — the file changed too much; ask the agent to re-read the file and retry.
← Docs