Troubleshooting - FoysalAhammad/agent24 GitHub Wiki

๐Ÿงฏ Troubleshooting

๐Ÿ” Permission popup did not appear

  • Check you are not in yolo/skip mode or auto_accept_permissions (Settings โ†’ Advanced)
  • An earlier Always may cover it โ€” it resets on /new or app restart
  • Look for the permission notification (enable notifications for Agent 24)
  • Background session? Switch to it โ€” pending popups re-show on focus

๐ŸŒ Provider errors

Code Meaning What to do
401 bad key re-enter it with /connect
402 quota empty top up or switch provider
429 rate limited wait โ€” auto-retry backs off by itself
5xx provider down fallback kicks in; or /model another

๐Ÿ“ฑ Storage & terminal

  • First launch asks for storage + all-files access โ€” if you skipped it, Settings โ†’ Apps โ†’ Agent 24 โ†’ Permissions
  • Terminal needs storage symlinks: they are built automatically on first run

๐Ÿ” The agent stopped mid-task

Tap the retry chip on the reply โ€” oversized tool calls are now split into smaller ones automatically; check Sessions for the queue state.

๐Ÿ› Still stuck?

Open an issue: https://github.com/FoysalAhammad/agent24/issues โ€” include the session export (/export) if you can.


๐Ÿ  Home ยท Docs site ยท Repository ยท Report an issue

โš ๏ธ **GitHub.com Fallback** โš ๏ธ