Skip to content

Releases: operator-kit/ghapp-cli

v0.1.1

23 Feb 18:31

Choose a tag to compare

Changelog

  • 58ff56f add ghapp config command for non-interactive setup
  • d6a85d9 streamline auth configure/reset UX

v0.1.0

23 Feb 17:14

Choose a tag to compare

ghapp v0.1.0 — Initial Release

ghapp is a CLI tool that authenticates as a GitHub App, generates installation tokens, and configures git and gh to use them transparently.

Use cases: AI Agents & LLMs, CI/CD pipelines, VPS automation, self-hosted runners, or any environment where you need machine-identity GitHub access without personal tokens.

Features

  • Interactive setupghapp setup walks you through App ID, Installation ID, and private key configuration
  • Transparent auth — configures git credential helpers and gh auth so clones, pushes, and gh commands just work
  • Token management — generates short-lived installation tokens with automatic caching and refresh
  • Self-updateghapp update checks GitHub releases and replaces the binary in-place; a background check runs daily
  • Cross-platform — prebuilt binaries for Linux, macOS, and Windows (amd64 + arm64)

Install

Homebrew (macOS/Linux):

brew tap operator-kit/tap && brew install ghapp

Bash (Linux/macOS):

curl -sSL https://raw.githubusercontent.com/operator-kit/ghapp-cli/main/install.sh | bash

PowerShell (Windows):

irm https://raw.githubusercontent.com/operator-kit/ghapp-cli/main/install.ps1 | iex

Go:

go install github.com/operator-kit/ghapp-cli/cmd/ghapp@latest

Binaries

OS Arch Asset
Linux amd64 ghapp_0.1.0_linux_amd64.tar.gz
Linux arm64 ghapp_0.1.0_linux_arm64.tar.gz
macOS amd64 ghapp_0.1.0_darwin_amd64.tar.gz
macOS arm64 (Apple Silicon) ghapp_0.1.0_darwin_arm64.tar.gz
Windows amd64 ghapp_0.1.0_windows_amd64.zip

All archives include SHA256 checksums in checksums.txt.