What problem does it solve?
It automates the repetitive, error-prone steps required to land a feature branch: detect the base branch, run tests, review diffs, bump versions, update changelogs, commit, push, and create a pull request so engineers can ship reliably and quickly.
Core Features & Use Cases
- Detect & Merge Base: Finds the repository's base branch, merges it into the feature branch, and reports conflicts.
- Run Tests & Gates: Executes the test suite and enforces safety gates for failing tests or low coverage before proceeding.
- Release Prep: Bumps VERSION (micro/patch by default), auto-generates CHANGELOG entries from the diff, and creates tidy, bisectable commits.
- PR Creation: Pushes changes and opens a pull request with a summary of changes, test results, version bump, and any review findings.
- Use Case: From a feature branch with staged changes, run this to produce a merge-ready PR with version and changelog updates, saving manual checklist work.
Quick Start
Run the ship workflow to detect the base branch, run tests, bump VERSION, update CHANGELOG, commit and push changes, and open a pull request.