Container Update Advisor
/install container-update-advisor
Container Update Advisor
Check all running Docker containers against Docker Hub for newer versions, fetch changelogs, and output a prioritized markdown report with risk flags.
Scripts
All scripts live in scripts/ relative to this file. Run from that directory.
| Script | Purpose |
|---|---|
scan_containers.py |
List running containers + image tags (outputs JSON) |
check_updates.py |
Query Docker Hub for newer versions (stdin/file → JSON) |
fetch_changelog.py |
Fetch GitHub release notes for updated images (stdin/file → JSON) |
format_report.py |
Render prioritized markdown report (stdin/file → stdout) |
Full Pipeline
python3 scan_containers.py \
| python3 check_updates.py \
| python3 fetch_changelog.py \
| python3 format_report.py
To save intermediate output for debugging, pass each script's output as a file argument to the next:
python3 scan_containers.py > /tmp/c.json
python3 check_updates.py /tmp/c.json > /tmp/u.json
python3 fetch_changelog.py /tmp/u.json > /tmp/ch.json
python3 format_report.py /tmp/ch.json
Risk Assessment Logic
- Major version bump → 🔴 review first
- Minor version bump → 🔴 review first (may have API changes)
- Changelog mentions "breaking" → 🔴 review first
- Patch bump only, no breaking keywords → 🟢 safe to update
What Gets Skipped
- Containers using
latesttag (no version to compare) - Digest-pinned images (
sha256:...tags) - Non-Docker Hub registries (GHCR, ECR, etc.)
- Private images (401/403 → skipped gracefully)
- Non-semver tags (e.g.
alpine,focal,slim)
GitHub Token (Optional)
Set GITHUB_TOKEN env var to increase GitHub API from 60 → 5,000 req/hr:
export GITHUB_TOKEN=ghp_yourtoken
Reference
See references/setup-guide.md for scheduling, rate limits, and how image matching works.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install container-update-advisor - After installation, invoke the skill by name or use
/container-update-advisor - Provide required inputs per the skill's parameter spec and get structured output
What is Container Update Advisor?
Check running Docker containers for newer image versions and generate a prioritized update report. Fetches release notes and flags breaking changes vs safe u... It is an AI Agent Skill for Claude Code / OpenClaw, with 120 downloads so far.
How do I install Container Update Advisor?
Run "/install container-update-advisor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Container Update Advisor free?
Yes, Container Update Advisor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Container Update Advisor support?
Container Update Advisor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Container Update Advisor?
It is built and maintained by New Age Investments (@newageinvestments25-byte); the current version is v1.0.0.