Error Code Library

Match the error message, jump straight to the fix. Each card deep-links to symptoms, root cause, step-by-step repair, and prevention.

Prefer a printable list? Use the common errors cheat sheet or browse the troubleshooting library.

System & Access

Permission Denied / File Access

Jump to: macOS/Windows folder access, TCC prompts, and EACCES fixes.

macOSPermissions

Tool Execution Failed (127)

Jump to: command-not-found, nvm/Homebrew PATH, absolute-path fixes.

ShellPath

MCP Connection Failed

Jump to: dead MCP process, wrong port, VPN/firewall blocks.

MCPNetwork

Context & Logic

Context Window Exceeded

Jump to: 200K/1M token overflow, reset, and .coworkignore.

TokensLimits

Stale Context Warning

Jump to: forgotten instructions, re-read files, summarize-and-restart.

MemoryDrift

Hallucinated File Paths

Jump to: ENOENT paths, wrong src/, structure maps.

Hallucination

Workflow & Runtime

Git Merge Conflict Loop

Jump to: stop the loop, abort merge/rebase, manual resolve.

GitLoops

NPM Dependency Hell

Jump to: ERESOLVE, peer deps, clean install without --force.

NPMNode

Sub-Agent Timeout

Jump to: hung agents, stop conditions, lower parallelism.

AgentsTimeout

Rate Limit Exceeded (429)

Jump to: RPM vs TPD, backoff, throttle sub-agents.

APIBilling