Skip to main content
A run is “stuck” when progress stops or drift keeps increasing.

​
1. Reset with a clear state summary

Ask for:
  • what was attempted
  • what failed
  • current repository state
  • smallest viable next step

​
2. Re-scope aggressively

Replace broad requests with a single bounded request. Example: 
Only fix failing test <name>. Do not modify unrelated files.

​
3. Use worktree bootstrap if environment is the issue

If failures are setup-related, configure Settings > Worktree Bootstrap so new worktrees start from a prepared state.

​
4. Re-run and re-review

After reset, re-run and inspect diff immediately.

​
5. Escalate when needed

If repeated runs fail for environment/network/provider reasons, move to Troubleshooting pages and fix the root condition first.