Gentoo overlay maintenance tools. Use /check-updates to find outdated packages, /update-ebuild to bump versions.
Maintenance tools for turbo-overlay Gentoo packages.
Scan packages for available upstream updates.
# Check all packages
.agents/skills/overlay-tools/bin/check-updates
# Check specific package
.agents/skills/overlay-tools/bin/check-updates -p net-im/goofcord
# JSON output for scripting
.agents/skills/overlay-tools/bin/check-updates --json
If a package is reported as manual-check, see
.agents/skills/overlay-tools/docs/manual-update-checks.md.
Options:
| Flag | Description |
|---|---|
-p, --package CATEGORY/NAME | Check specific package only |
--json | Output JSON format |
-v, --verbose | Show detailed progress |
--overlay-path PATH | Path to overlay (default: current directory) |
Exit Codes: 0 = updates available, 1 = errors, 2 = all up-to-date
Bump ebuild versions with optional PR automation.
# Version bump
.agents/skills/overlay-tools/bin/update-ebuild -y -v 1.2.3 media-video/hayase-bin
# With MY_PV mapping
.agents/skills/overlay-tools/bin/update-ebuild -y -v 0.2025.12.10.08.12_p03 -m "0.2025.12.10.08.12.stable_03" x11-terms/warp-bin
# Dry run
.agents/skills/overlay-tools/bin/update-ebuild -n -v 2.0.0 net-im/goofcord
# Create PR automatically (--pr implies -y)
.agents/skills/overlay-tools/bin/update-ebuild --pr -v 3.68.0_pre -m "3.68.0" media-video/lossless-cut
Options:
| Flag | Description |
|---|---|
-v, --version VERSION | New version (required) |
-m, --my-pv MY_PV | Set MY_PV for upstream version mapping |
-n, --dry-run | Preview changes without applying |
-s, --skip-git | Skip git operations |
-l, --lenient | Allow non-standard version formats |
-k, --keep-old | Keep old ebuild |
--skip-manifest | Skip Manifest update (for CI) |
-y, --yes | Auto-commit without prompting |
--pr | Create PR after committing (implies -y) |
--base BRANCH | Base branch for PR |
--branch BRANCH | Override feature branch name |
--draft | Create PR as draft |
--upstream-url URL | Upstream release URL for PR body |
curl -LsSf https://astral.sh/uv/install.sh | sh| Variable | Description |
|---|---|
GITHUB_TOKEN | GitHub API token for higher rate limits |
check-updates to find outdated packagesupdate-ebuild --pr to bump version and create PRupdate-ebuild -v X.Y.Z category/packageemerge -1v category/packagepkgcheck scan category/package| Gentoo Format | Meaning |
|---|---|
1.2.3 | Standard release |
1.2.3_p1 | Patch release |
1.2.3_pre | Pre-release |
1.2.3_alpha1 | Alpha |
1.2.3_beta2 | Beta |
1.2.3_rc1 | Release candidate |