prune
release prune - Remove old pre-releases and their tags, keeping only the newest N
Prunes old pre-releases for a module, keeping only the specified number of newest releases.
This command: - Lists all releases matching the module prefix (e.g., docs/*) - Keeps the newest N releases (default: 3) - Deletes older releases and their associated git tags
Use this after successful releases to maintain a clean release history.
Flags
| Flag | Description |
|---|---|
--keep (default: 1) |
Number of releases to keep per module |
--all |
Prune all modules with releases |
--dry-run |
Show what would be deleted without deleting |
Notes
Expected Output:
- Count of releases found
- List of releases deleted (if any)
- Summary of cleanup results
Examples
release prune docs # Keep 3 newest docs/* releases
release prune books --keep 5 # Keep 5 newest books/* releases
release prune --all --keep 3 # Prune all modules
See Also
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.