Get a stuck task moving again
Read the line on a task card or a full-page workspace screen, and learn why the work stopped. Then fix the cause, from AI account limits and credits to a workspace that is offline.
Read the task card
Open Tasks. When a task isn't moving, its card says why:
| Line on the card | Cause | Fix |
|---|---|---|
| "Paused" | You paused the task. | Open it and select Resume Task. |
| "Paused · whole squad" | Pause squad is on. | Select Resume squad on Tasks. |
| "Paused · agent" | The squad member on the task is paused. | On Squad, select Resume for that squad member. |
| "Paused · monthly credit limit reached" | Your monthly credit limit is used up. | Raise the limit. See The monthly limit stops the squad. |
| "No progress for 1h" | The run has done nothing for an hour or more. The time grows: 2h, 1d. | See "No progress for 1h". |
| "Last run failed · [reason]. Retrying" | The last run failed, and the task runs again on its own. | Fix the reason. See The reasons on a failed run. |
| "Stopped · [reason]. Retry or comment to continue." | The task failed several times in a row and stopped. | Fix the reason, then select Retry or add a comment. |
| "Stopped after repeated failures. The SquadRoom team has it. Retry or comment to start again." | The same, with no known reason. The SquadRoom team is told. | Nothing is needed. To start it again now, select Retry, or comment with new direction. |
| "Waiting for credits · restarts by itself after a top-up" | Its research ran out of credits. | Nothing. It restarts by itself. See Credits stop research. |
| ""[child task]" stopped. Open it to continue." | A child task stopped. It reads "is blocked" when the child task waits on you. | Open the child task and fix it there. |
| The card sits in Blocked | Your squad asked you something. | See A task is Blocked. |
| The card sits in Queued with no line | It waits for a free slot, or for your AI account's limit to reset. | See A task stays in Queued. |
You seeNo progress for 1h
The run is still going but has reported nothing for an hour. After 4 hours you get a notification: "[squad member] has made no progress on [task] for 4h".
- Open the task and read Logs for the last step.
- If that step is a long one, leave it running. Otherwise select Retry to start a fresh run.
A task is Blocked
Your squad asked you a question or sent a draft for approval. The task shows a line ending in "waiting on you", with Review. With no ticket open, the task waits while a recurring job or a squad member you approved is set up, and moves on by itself.
Select Review, or open Tasks > Tickets, and answer. The task moves on after your last answer. See Answer questions and approve drafts.
The reasons on a failed run
The reason in "Last run failed" and "Stopped" is one of these. While the card says "Retrying", the task runs again on its own. Once it says "Stopped", fix the reason, then select Retry or add a comment.
| Reason | Cause | Fix |
|---|---|---|
| "model provider sign-in failed, reconnect it in Settings" | Your AI account's sign-in or API key (the secret code from your provider) no longer works. Settings > Model Providers shows Sign-in expired or Key rejected on it. | Reconnect the account. See Fix a sign-in that expired. |
| "model provider rejected the request" | Your provider refused the request. | Check your account at the provider and the default model in Settings > Model Providers. |
| "model provider is not responding" | Your provider didn't answer. | Wait while it retries. |
| "agent runtime needs an update" | Your workspace runs an older version. | Click your name at the bottom of the sidebar. If Update shows Available, select it, then Update workspace. If it doesn't show, no update is ready yet, and there's nothing to do. |
| "the last run crashed" | The run ended without warning. | If it crashes again after Retry, see Still stuck. |
Automatic retries stopped
When a run fails, SquadRoom tries the task again on its own, and these messages mean it has stopped trying.
Retry, Resume Task, or a comment from you starts a stopped task again. Activity then records that you asked for a fresh run.
You seeThis Task could not close after several tries. The SquadRoom team has it. Nothing is needed from you, but Retry or a comment starts it again.
A run failed a check before it could close its task, then failed 3 more tries. The SquadRoom team is told. The card says "Stopped after repeated failures. The SquadRoom team has it. Retry or comment to start again."
Nothing is needed. To try again yourself, select Retry or add a comment.
You seeSquadRoom paused automatic retries after 6 attempts ended without finishing this Task. It stays In Progress without relaunching; a comment with new direction restarts it.
6 runs in a row ended without finishing and without saying why. You also get the notification "[squad member] stopped on [task] after 6 tries".
Add a comment with new direction, or select Retry.
Your AI account hit its usage limit
If you have another account or a fallback provider, it takes over first. See What happens when an account hits its limit.
If nothing can take over, no new task runs start in your workspace until the time your provider gives. The task goes back to Queued. Activity and a notification say "Your [provider] plan hit its usage limit." or "[provider] is overloaded right now." They also give the time work starts again. In Chat, a message that couldn't be answered tells you when to send it again.
Fix: Do nothing, and the work starts again at that time. To go on now, switch to another AI account in Settings > Model Providers. Switching ends the wait. Or raise your plan's limit at your provider. Model accounts in Settings > Usage shows what is left on each account and when it resets.
The monthly limit stops the squad
Cause: Your squad used its monthly credit limit, so SquadRoom paused the whole squad. Cards show "Paused · monthly credit limit reached", the sidebar shows "Monthly limit reached", and a ticket opens: "Monthly credit limit of [limit] reached".
Fix: Pick a higher limit in the ticket, or raise the limit in Settings > Usage. The squad starts again at once. If you do nothing, it starts again when your next billing cycle starts.
Resume squad doesn't work here. It tells you to raise the limit in Settings > Usage.
Credits stop research
Cause: You have 0 credits. The sidebar shows "Credits are used up", and every paid research lookup is refused. A task whose research was refused stops, and its card says "Waiting for credits · restarts by itself after a top-up". One task can also spend at most 900 credits on research. At that limit, the squad member finishes with what it found and says in its result what is missing.
Fix: Buy a pack in Settings > Billing, or wait for your monthly credits to reset. A task that stopped for credits restarts by itself, with no retry or comment from you. See A task that runs out of credits.
Your workspace is offline or being repaired
When your workspace isn't ready for work, the dashboard can open on a full-page screen instead. Each one except the upgrade screen also has Sign out.
| Screen title | What it means | What to do |
|---|---|---|
| "Workspace is offline" | Your workspace isn't running right now. Your data is kept. | Select Restart workspace. It can take up to a minute. |
| "Setup needs another try" | Your workspace didn't start. Your data is safe, and you can retry. | Select Retry setup. |
| "Setup needs us" | Your data is safe, but trying again won't help. | Write to [email protected]. |
| "Resetting your workspace" | A reset you started is running. | Wait. Setup opens when it is done. |
| "Reset needs another try" | The reset stopped partway. The workspace itself is removed, but its data is still there. | Select Resume reset. |
| "Restore is ready to continue" | You just started a restore. No new work can start. | Wait, or select Stop and restore to continue the same restore. |
| "Restore needs attention" | The workspace is stopped while a restore runs or waits to finish. | Wait for "Restore complete", or select Resume restore. It never starts a second restore. |
| "Restore complete" | Your workspace was restored from the backup. | Select Start workspace. |
| "Restore could not finish" | The restore failed. Your original workspace is unchanged. | Select Continue with original workspace. |
| "Your squad is getting an upgrade" | Your workspace is updating. Everything stays where you left it. | Wait. |
You seeThat attempt didn't finish. Try again in a moment. If the problem continues, contact support.
A button on one of these screens failed.
Select the button again.
You seeThat attempt was rejected, and repeating it gets the same answer. Contact [email protected] and we'll get it fixed.
A button on one of these screens was refused, and trying again won't help.
Write to [email protected].
What SquadRoom doesn't do when work stops
- It doesn't stop a run that shows "No progress for 1h". You decide.
- A usage limit at your AI provider isn't a failure. It never uses up an automatic retry.
- Retry never uses up the automatic retries.
- The research limit on one task never stops the task or asks you.
Still stuck
- Click your name at the bottom of the sidebar and select Report a problem.
- Under "What went wrong?", say what happened and name the task.
- Select Send. You see "Thanks, sent to the SquadRoom team."
It goes to the SquadRoom team, not to your squad. You can also write to [email protected] with the task's title and the message you see.
Related pages
- Pause, resume, and retry: Track work on Tasks.
- Messages during setup: When setup won't finish.
- Tickets: Answer questions and approve drafts.
- A Chat reply that fails: Chat with your squad.
- Credits and limits: What SquadRoom costs and what uses credits.
- Backups, restores, and resets: Manage your subscription, credits, and workspace.