bugtalk

Docker errors, translated instantly. Install once. Zero config. Zero new habits.

$ docker run -p 80:80 nginx
docker: Error response from daemon: Bind for 0.0.0.0:80 failed: port is already allocated.

🔧 [PORT_CONFLICT] Port 80 is already in use by another process
💡 Fix: lsof -ti:80 | xargs kill -9
⚠️  Risk: medium — review before running

Install

pip install bugtalk
bugtalk setup

Restart your shell. Done.

How it works

bugtalk setup adds a thin Python wrapper to the front of your PATH. Every docker run, start, exec, build, and compose up command passes through it invisibly. If the command fails, bugtalk matches the error against a library of known patterns and prints a plain-English fix.

• Exit codes are always preserved → CI/CD pipelines are unaffected
• Interactive commands (docker exec -it, docker run -it) are passed through with no capture → TTY sessions work normally
• The real Docker binary is stored as an absolute path during setup → no infinite recursion, no PATH games
• Works offline — the pattern library is local
• Updates weekly in a background thread (non-blocking, never adds latency)

Commands

Supported platforms

Shell support: bash, zsh, fish, and any shell that sources ~/.profile.

Error patterns (v1.0, 25 patterns)

Uninstall

bugtalk unsetup

No original Docker files are ever modified. Uninstall is clean.

License

MIT