GitHub - Mikemiol17/bugtalk · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Mikemiol17
bugtalk
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>3 Commits<br>3 Commits
src/bugtalk
src/bugtalk
tests
tests
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
pyproject.toml
pyproject.toml
View all files
Repository files navigation
bugtalk
Docker errors, translated instantly. Install once. Zero config. Zero new habits.
$ docker run -p 80:80 nginx<br>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<br>💡 Fix: lsof -ti:80 | xargs kill -9<br>⚠️ Risk: medium — review before running
Install
pip install bugtalk<br>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
Command<br>What it does
bugtalk setup<br>Install wrapper, configure PATH
bugtalk unsetup<br>Remove everything, restore original Docker
bugtalk status<br>Show version, pattern count, last update
bugtalk update<br>Pull latest patterns from GitHub now
bugtalk report<br>Open a pre-filled GitHub issue for an unknown error
Supported platforms
Platform<br>Status
macOS (Intel + Apple Silicon)<br>✅ Supported
Linux (Ubuntu, Debian, Fedora, Arch)<br>✅ Supported
Windows (WSL2)<br>✅ Supported
Windows native<br>❌ Not in V1
Shell support: bash, zsh, fish, and any shell that sources ~/.profile.
Error patterns (v1.0, 25 patterns)
ID<br>Matches
PORT_CONFLICT<br>Port already allocated / address in use
DAEMON_NOT_RUNNING<br>Docker daemon not started
IMAGE_NOT_FOUND<br>Image not pulled locally
VOLUME_PERMISSION<br>Permission denied on mounted volume
NETWORK_CONFLICT<br>Network already exists
CONTAINER_ALREADY_RUNNING<br>Container already started
DISK_SPACE<br>No space left on device
INVALID_TAG<br>Bad image reference format
PULL_RATE_LIMIT<br>Docker Hub rate limit hit
AUTH_REQUIRED<br>Registry login needed
COMPOSE_ORPHAN<br>Orphan containers from old compose project
COMPOSE_VERSION<br>Obsolete version: field in compose file
CONTEXT_NOT_FOUND<br>Unknown docker context
BUILD_NO_DOCKERFILE<br>Dockerfile missing from build context
BUILD_ARG_MISSING<br>--build-arg not passed for declared ARG
PORT_FORMAT_INVALID<br>Malformed -p flag
EXEC_NOT_RUNNING<br>exec on a stopped container
EXEC_CMD_NOT_FOUND<br>Binary not in container PATH
LAYER_CACHE_MOUNT<br>BuildKit not enabled
MANIFEST_PLATFORM<br>No image for this CPU architecture
DNS_RESOLUTION<br>DNS failure inside container
COMPOSE_PORT_CONFLICT<br>Compose service port conflict
HEALTHCHECK_FAIL<br>Container healthcheck failing
SECCOMP_DENIED<br>System call blocked by seccomp
CGROUP_OOM<br>Container OOM-killed
Uninstall
bugtalk unsetup
No original Docker files are ever modified. Uninstall is clean.
License
MIT
About
No description, website, or topics provided.
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python<br>100.0%
You can’t perform that action at this time.