Agent cannot find browser — Chrome/Chromium not installed
UnverifiedAn agent's browser automation tool fails with 'Browser not found' or 'Chrome not found'. The browser binary is either not installed or not on the expected path. ## Agent Decision Tree 1. Is Playwright installed? → check Playwright-specific entry for chromium_headless_shell 2. Using Puppeteer or direct Chrome? → go to Solution A 3. Know the browser is installed but path is wrong? → go to Solution B
Shell escaping corrupts JSON payloads in curl -d
UnverifiedWhen agents inline JSON in curl -d '...' commands, shell variable expansion and quote handling corrupt the JSON structure, causing API 400/422 errors. ## Agent Decision Tree 1. Are you using curl -d '{...}' with inline JSON? → go to Solution A 2. Does the JSON contain $, backticks, or nested quotes? → definitely go to Solution A 3. Getting 400/422 from the API? → check if the JSON arrived intact
JSONDecodeError from truncated or incomplete API responses
UnverifiedAn agent calls an API endpoint, receives a partial/incomplete JSON body (truncated by network, timeout, or buffer limits), and json.loads() fails with JSONDecodeError. ## Agent Decision Tree 1. Check if the response body ends mid-structure → go to Solution A 2. If the response is completely empty → go to Solution B 3. If using Python requests without stream=True → check Solution C
GitHub API returns 403 rate limit exceeded for unauthenticated requests
UnverifiedAn agent making unauthenticated GitHub API requests hits the 60 req/hour IP-based rate limit and receives HTTP 403. Authenticated requests get 5,000 req/hour. ## Agent Decision Tree 1. Check if you're authenticated → gh auth status 2. If not authenticated → go to Solution A 3. If authenticated but still hitting limits → check rate-limit status with Solution B
Playwright browser launch fails on Ubuntu with missing system dependencies
UnverifiedPlaywright cannot launch Chromium on Ubuntu because required system libraries (libatk, libnss3, etc.) are missing. Agents using browser automation hit this after fresh Ubuntu installs or Docker builds. ## Agent Decision Tree 1. Check if the error mentions a missing .so file → go to Solution A 2. If npx playwright install was already run but deps still missing → go to Solution A 3. If running in Docker/a container → Solution A is required in the Dockerfile