AI coding troubleshooting guides
Choose the problem you can observe, then the guide for your tool.
Stuck, hanging or looping agents
- Roo Code API Request stuck or failed? Here are the fixes that actually work.
Roo Code API request stuck or failed? Ranked fixes for rate limits, context overflow, Ollama hangs, provider stalls, and protecting your half-done session.
- Aider looping, repeating lint fixes or ignoring Ctrl-C?
Diagnose Aider task loops, repeated lint or test failures, and ineffective interrupts. Check the diff, failing command and child process before retrying.
- Antigravity stays in Thought Process? Capture progress before restarting.
Antigravity stuck in Thought Process? Check approvals, tool activity and repository changes before altering settings or restarting.
- ChatGPT stuck on Thinking? Fix the spinner without losing the work.
ChatGPT stuck on Thinking, one last tweak, thinking failed, Generating, or Working? Stop the spinner, check status, preserve work, and restart safely.
- Cline API request stuck, model switch failed or 503?
Diagnose Cline request stalls, model-selection failures and 503 or no healthy upstream responses. Preserve provider details and the diff before retrying.
- Copilot Agent stuck, retrying or incomplete? Verify the work
Check Copilot terminal waits, repeated no-response retries, and incomplete results. Preserve the diff and verify each symptom before restarting.
- Copilot Send button disabled: check the setting
Copilot Send button does nothing? Test the reported parent-customization setting conflict, then check access, diagnostics and Copilot logs.
- Crush stuck on Generating?
Crush stuck on Generating after a provider or base URL error? Stop the retry loop, verify configuration, preserve Git state, and resume safely.
- Cursor Composer stuck on Generating or Taking longer than expected?
Cursor Composer stuck on Generating, Applying, or Taking longer than expected? Preserve partial work, diagnose the request, and recover the persisted chat safely.
- Devin repeating actions or stalled? Check task and usage
Check a repeating or stalled Devin task, its usage display and latest branch. Keep remote task status separate from saved code and billing questions.
- Gemini CLI stuck on Running or silent at startup?
Check Gemini CLI shell completion and silent startup separately. Preserve configuration, inspect the child process and verify the project before retrying.
- Kilo Code retry loop: reject repeats and check the diff
Kilo Code retry loop? Require approval for repeated failures, reject repeated edits, preserve the diff, and test one focused request.
- Kiro stuck in Working: fix terminal integration before clearing cache
Kiro stuck in Working? Follow documented shell-integration fixes, protect changed files, and understand why a clear-cache reset is not a verified repair.
- Lovable preview stuck loading? Identify the failing layer first.
Lovable stuck after login or on a loading screen? Check Supabase auth callbacks and recover from a Git-synced project state.
- OpenClaw agent stopped responding after a tool call?
OpenClaw agent stopped replying after a tool call? Back up the session, check tool-call pairing, quarantine corrupted state, and restart safely.
- OpenCode hangs after tool calls or Escape? Verify files
Check OpenCode tool-call hangs, uncertain writes and ineffective Escape interrupts. Verify the process and files before replaying an action.
- Qwen Code Tool Call Not Working? Fix Execution Errors
Qwen Code tool call not working or not executing? Check backend support, model templates, command handling, and recovery state before retrying.
- Replit Agent stuck working: Stop, Cancel and rollback explained
Stop a stuck Replit Agent turn, inspect checkpoints, and distinguish reversible recovery from Cancel, which discards isolated background-task work.
- Trae stuck Thinking: check for a crash before restarting
Trae stuck Thinking or Analyzing? Preserve changes, distinguish a Windows agent crash from a stalled chat, and report the exact symptoms.
- Windsurf Cascade stuck, looping or freezing?
Distinguish a Cascade spinner, repeated edits and an IDE freeze. Check process activity, workspace scope and the diff before restarting Windsurf.
- Cursor terminal command stuck or waiting forever?
Cursor terminal command stuck or agent waiting forever? Preserve output and changed files, identify interactive commands, and restart with a bounded check.
- Cline stuck after a terminal command?
Cline stuck thinking after a terminal command or waiting forever? Preserve the diff, identify interactive commands, and restart with a finite check.
Usage and rate limits
- Claude Limit Reset: Reset Times and Free Reset
Claude limits use a five-hour session and weekly window. If eligible, use "Reset for free" in Settings > Usage; check your account's exact reset times.
- Claude usage limit reached? Preserve work before restarting
Identify Claude session, weekly and shared usage limits, preserve the coding state and prepare a verified handoff before waiting or starting a new chat.
- Codex hit a rate limit. Your coding session does not have to die.
Check Codex usage and reset details, distinguish plan limits from API 429 errors, then preserve local coding state before resuming or switching tools.
- Cursor limit reached: check the allowance before paying more
Understand a Cursor limit, find your reset date in the Spending dashboard, compare remaining usage pools, and review on-demand spending before continuing.
- DeepSeek rate limited or server overloaded?
DeepSeek 429 rate limit, 503 server overloaded, or 402 insufficient balance? Match the code, stop blind retries, and preserve coding work.
- Factory Droid rate limit reached mid-session?
Factory Droid hit a 5-hour, weekly, or monthly rate limit? Use /limits, preserve the completed request, and continue with Droid Core or another tool.
- Gemini usage limit reached mid-task?
Gemini usage limit reached or context too large? Check the reset, switch to Fast or Flash-Lite, and preserve the coding state before continuing.
- Grok returned 429 Too Many Requests?
Grok API returned 429 Too Many Requests? Reduce request rate, use exponential backoff, preserve partial coding work, and retry safely.
- Kimi Code usage limit or context too long: match the error
Separate Kimi Code quota, overload and context errors. Check usage, compact or start a new session, and preserve work before retrying.
- Perplexity returned 429 Too Many Requests?
Perplexity API returned 429 Too Many Requests? Use jittered backoff, preserve partial agent work, and continue from a verified packet.
- Z.ai GLM Coding Plan limit reached?
Z.ai GLM limit reached, weekly quota exhausted, or high traffic? Match codes 1308, 1310, 1312, 1305, and 1261 before retrying.
Context, compaction and lost sessions
- Recover an AI coding session from the work that survived.
Recover an AI coding task after Claude, Cursor, Codex, Gemini, or another tool dies, gets stale, hits a limit, or moves tools. Learn what the next session needs.
- Amp thread lost context after compaction?
Amp thread too long or missing details after auto-compaction? Preserve the Git-backed state, start a focused thread, and verify what the summary omitted.
- Claude Code session recovery: resume first, then verify.
What to do when a Claude Code session dies, hits usage limits, gets stale, or can no longer continue a coding task. Recover from disk truth, not memory.
- Claude context limit recovery: inspect, compact, or restart.
Claude or Claude Code context too long, compacted, or drifting? Restart clean with verified project state instead of a bloated transcript.
- Cline checkpoints taking too long to initialize or stuck at 0 tokens?
Fix Cline checkpoint initialization timeouts and 0-token stalls. Reopen a Git-backed project or disable checkpoints, then verify the diff before retrying.
- Cursor chat getting stale? Start fresh without starting over.
How to restart a stale Cursor chat without losing git diff, changed files, failed attempts, decisions, tests, and next action.
- Run DeepSeek V4 Flash in Codex CLI.
Run DeepSeek V4 Flash in Codex CLI through LM Studio or a Responses-compatible gateway. Fix model, tool-call, API, and context errors.
- ShardStitch support across 31 AI handoff targets across native integrations and web-chat handoff is layered, not identical.
Check ShardStitch feature coverage across supported AI handoff targets: disk scan, file injection, MCP, manual handoff and Recall.
- Move from Claude Code to OpenClaw without losing the coding state.
Move coding work from Claude Code to OpenClaw with a verified local handoff: current diff, decisions, failed attempts, checks, and one safe next action.
- Codex session corrupted or cannot resume?
Codex session corrupted or cannot resume? Preserve the repository state, rebuild a verified continuation packet, and continue without trusting a broken session.
- Gemini CLI session lost or cannot resume?
Gemini CLI session lost, missing, or not resumable? Recover from Git diff, shell evidence, and a verified continuation packet.
Crashes and startup failures
- Amazon Q chat stuck starting? Use logs to locate the failing stage.
Amazon Q chat stuck starting up? Preserve project changes and inspect logs for authentication, network or chat-processing errors.
- Claude Desktop task stopped mid-run?
Claude Desktop or Cowork stopped mid-task? Check app state, sleep, permissions, Windows virtualization, and logs before restarting the work.
- OpenCode Desktop freezes at startup? Separate repository and plugin checks.
OpenCode Desktop freezes at startup on a large repository? Use ignore rules, preserve the diff, and restart with a bounded workspace.
- Codex CLI Stuck or Frozen? Fix It Without Losing Work
Codex CLI stuck, frozen, or not responding? Preserve completed work, diagnose the stalled session, then resume or fork without replaying verified changes.
Guides by tool
- Aider: Aider looping, repeating lint fixes or ignoring Ctrl-C?
- Amazon Q Developer: Amazon Q chat stuck starting? Use logs to locate the failing stage.
- Amp: Amp thread lost context after compaction?
- Antigravity: Antigravity stays in Thought Process? Capture progress before restarting.
- ChatGPT: ChatGPT stuck on Thinking? Fix the spinner without losing the work.
- Claude.ai: Claude context limit recovery: inspect, compact, or restart.; Claude Limit Reset: Reset Times and Free Reset; Claude usage limit reached? Preserve work before restarting
- Claude Code: Claude Code session recovery: resume first, then verify.
- Claude Desktop: Claude Desktop task stopped mid-run?
- Cline: Cline API request stuck, model switch failed or 503?; Cline checkpoints taking too long to initialize or stuck at 0 tokens?; Cline stuck after a terminal command?
- Codex CLI: Codex hit a rate limit. Your coding session does not have to die.; Codex CLI Stuck or Frozen? Fix It Without Losing Work; Codex session corrupted or cannot resume?
- GitHub Copilot: Copilot Agent stuck, retrying or incomplete? Verify the work; Copilot Send button disabled: check the setting
- Crush: Crush stuck on Generating?
- Cursor: Cursor limit reached: check the allowance before paying more; Cursor chat getting stale? Start fresh without starting over.; Cursor Composer stuck on Generating or Taking longer than expected?; Cursor terminal command stuck or waiting forever?
- DeepSeek: DeepSeek rate limited or server overloaded?; Run DeepSeek V4 Flash in Codex CLI.
- Devin: Devin repeating actions or stalled? Check task and usage
- Factory Droid: Factory Droid rate limit reached mid-session?
- Gemini CLI: Gemini CLI stuck on Running or silent at startup?; Gemini CLI session lost or cannot resume?
- Gemini web: Gemini usage limit reached mid-task?
- Grok: Grok returned 429 Too Many Requests?
- Kilo Code: Kilo Code retry loop: reject repeats and check the diff
- Kimi: Kimi Code usage limit or context too long: match the error
- Kiro: Kiro stuck in Working: fix terminal integration before clearing cache
- Lovable: Lovable preview stuck loading? Identify the failing layer first.
- OpenClaw: OpenClaw agent stopped responding after a tool call?; Move from Claude Code to OpenClaw without losing the coding state.
- OpenCode: OpenCode Desktop freezes at startup? Separate repository and plugin checks.; OpenCode hangs after tool calls or Escape? Verify files
- Perplexity: Perplexity returned 429 Too Many Requests?
- Qwen Code: Qwen Code Tool Call Not Working? Fix Execution Errors
- Replit: Replit Agent stuck working: Stop, Cancel and rollback explained
- Roo Code: Roo Code API Request stuck or failed? Here are the fixes that actually work.
- Trae: Trae stuck Thinking: check for a crash before restarting
- Windsurf: Windsurf Cascade stuck, looping or freezing?
- Z.ai GLM: Z.ai GLM Coding Plan limit reached?
- Across tools: Recover an AI coding session from the work that survived.; ShardStitch support across 31 AI handoff targets across native integrations and web-chat handoff is layered, not identical.