pux tells you why your build failed before you open GitHub.
npm install -g pux.shclick to copy/\_/\ ( ^.^ ) > ^ <
Live · press q to quit
works with
the problem
every CI failure today is the same ritual. open GitHub, find the run, scroll through 8000 lines of logs, copy the error, paste it into your AI, get asked for more context, copy the diff, paste again, repeat.
by the time you have enough context pasted in, you've lost 25 minutes and opened 7 tabs. the fix was probably one line.
pux removes this entire loop. push your code, let the cat watch. when CI fails, your AI already has the full picture — logs, diff, config, everything — zero tabs, zero copy-paste.
how it works
you push code. pux detects it, polls GitHub Actions until the run finishes. if it fails, pux pulls the logs, extracts the stacktrace, grabs your diff and changed files, stores a full timestamped artifact bundle under .ai-context/failures/, and refreshes .ai-context/failure.mdas the latest entrypoint.
your AI agent — claude, codex, cursor, copilot, whoever — picks it up on the next prompt. no tabs, no scrolling, no manual copy-paste. the context is already there.
git push → pux watches → build fails → context written. that's it.
features
real-time CI monitoring
watches GitHub Actions runs with live job and step progress. animated progress bar, per-job status.
multi-provider support
monitors GitHub Actions and Vercel deployments side by side. auto-detects monorepos and watches all pipelines from a single view.
automatic failure context
when CI fails, downloads logs, extracts the relevant error window, collects diff and config files.
AI agent integration
auto-injects context pointers into CLAUDE.md, AGENTS.md, .cursorrules, and 6 other agent files.
adaptive live polling
detects pushes and new commits automatically. polls every 3s during active builds, backs off when idle.
ambient companion
a small cat lives in your terminal. watches your builds. reacts to success and failure. never interrupts.
works with your AI
pux auto-connects failure context to whichever agent you use.
get started
npm
npm install -g pux.shcopyhomebrew
brew install Blackrose-blackhat/pux/puxcopythen run
pux watchcopypux doctorcopyrequires Node.js 22+ and GitHub CLI authenticated. Vercel CLI optional for deployment monitoring.