v0.4.0-beta.1

v0.4.0-beta.1

This first beta adds PR worktrees, supports more coding agents, and adds Homebrew and native Linux packages. If you find a problem, include the output of gha version --format json in your report.

Before you upgrade

Commands that change local or GitHub state now execute by default after their safety checks. Use --dry-run to preview changes. We removed the old confirmation flag. Check scripts that rely on commands running as previews.
Explicit targets and safety checks still apply.
#16.

Upgrade the executable through its package manager or release archive first.
Then run gha update --dry-run to preview agent guidance changes and gha update` to apply compatible changes. This command updates guidance only.

Install or upgrade

On macOS, run brew install --cask raithlin/tap/gha. To upgrade, run brew update, then brew upgrade --cask gha. The release workflow updates the Homebrew tap automatically.

Linux users can download Debian/Ubuntu, Fedora, or Arch packages. Linux and macOS archives remain available for amd64 and arm64. Verify downloads against this release's checksums.txt. To upgrade a Linux package, download the new version and install it with your package manager. GHA does not host apt, dnf, or pacman repositories.

After you install, run gha version --format json. Its version field should read 0.4.0-beta.1. Run gha agent install to set up agent guidance separately.

See the setup guide and distribution guide for instructions. The macOS binaries are not signed with an Apple Developer ID or notarized. #31, #32.

Changes

• Work on PRs in separate checkouts. Use gha pr checkout <number> --worktree <path> to check out or resume a PR. GHA reports where to push changes, including PRs from forks. gha pr retire removes eligible checkouts for closed or merged PRs. It preserves local edits, unpublished commits, locked checkouts, and work whose safety it cannot establish. You can also list, add, and remove
  worktrees directly. #23, #26.
• See which branch changes completed. Branch commands check where Git will push and whether another Git operation is in progress. If a command partly fails, its JSON output records the changes that completed. On origin, a rename updates both branch names together or leaves both unchanged.
  #21, #24, #25.
• Set up more coding agents. GHA supports Codex, Claude Code, Pi, OpenCode, GitHub Copilot, Gemini CLI, Cursor, Hermes Agent, and OpenClaw. The installer detects agents you have set up without requiring their executables. Use --agent to select them explicitly. Shorter default guidance keeps the detailed skill available when needed.
  #14, #19, #20, #22.
• Keep guidance compatible with your binary. gha update checks that your binary supports the commands a skill requires. It preserves skills you customized and rejects updates your binary cannot support.
  #18, #19.
• Reuse your GitHub login and draft PR descriptions. GHA can reuse your gh login when GHA_GITHUB_TOKEN is unset. gha pr prepare drafts a description from local commits without fetching or creating a PR.
  #15, #17.
• Check release readiness with better diagnostics. Release checks use CI results for the selected commit and account for workflow retries. They accept skipped or neutral jobs alongside successful validation. GHA also reports build details and explains problems with unpublished branches or deleted
  upstream branches. Release publication checks the target and requires reviewed notes when the workflow requests them.
  #12, #13, #26, #28.

Install and upgrade tests cover Debian, Fedora, Arch, Intel Mac, and Apple Silicon. They check that package operations preserve customized guidance and that Homebrew rejects a download with the wrong checksum.

Commands to wait for a release or verify downloaded assets remain planned.
To verify a release, check its GitHub Actions run, published release, and downloads. Use gha capabilities --format json to list available commands.

Contributor: @Raithlin.

v0.3.0-alpha

v0.3.0-alpha

This alpha adds guarded release publication. gha release publish checks the selected commit, origin branch tip, existing tags, CI, and the tag-triggered workflow before showing the planned tag effects and requiring explicit confirmation.

Changes

• #9 adds the release publication workflow and updates the roadmap.
• #8 updates dependabot/fetch-metadata from v2 to v3.

The release also includes the 95% total statement coverage gate, supporting tests, and release and token-access documentation updates.

Contributor: @Raithlin.

v0.2.0-alpha

Changelog

• 8541029 feat: expand agent-ready repository workflows (#7)
• bb031c0 feat: migrate release notes command
• 6018355 feat: add branch cleanup candidates
• ad29f96 docs: align command surface with implementation
• 4821a65 fix: remove installed skill during agent uninstall
• 19f2727 feat: remove managed agent guidance
• 0108919 ci: add local check target
• 041a2b5 feat: add build version command
• b1fbef3 feat: add explicit origin branch refresh
• 6fb070c docs: add branch publication skill guidance
• ac93978 feat: add guarded branch publication
• 25b7812 docs: add pull request template
• 3e11c09 feat: add guarded pull request workflow
• ab84cad ci: update Node 24 compatible actions
• 164cfe1 ci: allow manual workflow runs
• 9904c34 Fix CI
• a339696 Correct ci changes
• e4b33cd Add golangci-lint
• 866ace5 Add CODEOWNERS
• d08ba06 build(deps): bump the go-dependencies group with 2 updates (#5)
• 0c3335f build(deps): bump actions/checkout from 4 to 7 (#6)
• dcd0e8e build(deps): bump actions/setup-go from 5 to 7 (#4)
• 7c709bc Add auto-merge for dependabot PRs
• 47ab2fe Add CI for testing
• e3b83dd Create dependabot.yml

v0.1.1-alpha

Changelog

• Add GitHub Actions workflow for release and GoReleaser configuration.
• Install agent guidance
• Merge pull request #3 from Raithlin:docs/workflow-automation-roadmap
• Document workflow automation principle
• Merge pull request #2 from Raithlin/feature/switch-before-delete
• Switch before deleting the current branch
• Merge pull request #1 from Raithlin:feature/local-git-analysis
• Align roadmap with command value guardrail
• Document workflow gaps
• Add local Git repository analysis
• Add guarded branch lifecycle commands
• Split README into focused guides
• Improve branch safety output
• Add branch safety inspection
• Roadmap agent adoption installation
• Neutralize code host provider boundary
• Define agent-first product direction
• Add local checkout selection
• Improve CLI agent readiness
• Make branch inventory agent-safe
• Add local and origin branch inventory
• Clarify release command contract

v0.1-alpha

Full Changelog: https://github.com/Raithlin/gha/commits/v0.1-alpha