Examples

Table of Contents

Adding a Tool

Register a Go-installed binary so gogitup can track it:

gogitup add ghorgsync

Install and register a tool directly from a full Go command package path:

gogitup install golang.org/x/vuln/cmd/govulncheck

Listing Tracked Tools

View all registered binaries, their installed versions, and the Go versions used to build them:

gogitup list

Registered Binaries

                                                      Installed  Go
  Name        Module Path                             Version    Version
  ──────────  ──────────────────────────────────────  ─────────  ───────
  bulkfilepr  github.com/UnitVectorY-Labs/bulkfilepr  v0.2.2     1.25.7
  ghorgsync   github.com/UnitVectorY-Labs/ghorgsync   v0.1.0     1.25.7

Go build versions matching the active locally installed toolchain are shown in green; versions that differ are shown in red.

Checking for Updates

See which tools have newer versions available:

gogitup check

Update Check

  Name        Installed  Latest  Update
  ──────────  ─────────  ──────  ──────
  bulkfilepr  v0.2.2     v0.2.3  yes   
  ghorgsync   v0.1.0     v0.1.0  no

The check command only checks for updates once every 24 hours, caching the latest version information. Use gogitup check --force to bypass the cache and fetch it again.

Upgrading All Tools

Run a single command to upgrade every tracked binary that has a newer release:

gogitup upgrade

gogitup upgrade --verbose
⟳ Upgrading 'bulkfilepr' from v0.2.2 to v0.2.3...
✓ Upgraded 'bulkfilepr' to v0.2.3
ℹ 'ghorgsync' is already up to date (v0.1.0)

✓ Upgraded 1 binary(ies).

To also rebuild otherwise-current binaries that were compiled with an older Go version:

gogitup upgrade --go-version

For example, if tool v1.2.3 was built with Go 1.25.6 and the active go command is Go 1.25.7, gogitup reinstalls tool@v1.2.3 directly. The existing binary is overwritten; it does not need to be uninstalled first.

Preview upgrades without installing anything or changing the cache:

gogitup upgrade --dry-run

Include Go-version rebuilds in the preview:

gogitup upgrade --dry-run --go-version

Using JSON Output for Scripting

Both list and check support --json for machine-readable output:

gogitup check --json

[
  {
    "name": "bulkfilepr",
    "installed_version": "v0.2.2",
    "latest_version": "v0.2.3",
    "update_available": true
  },
  {
    "name": "ghorgsync",
    "installed_version": "v0.1.0",
    "latest_version": "v0.1.0",
    "update_available": false
  }
]

Removing a Tool

Stop tracking a binary without uninstalling it:

gogitup remove ghorgsync

Stop tracking a binary and delete its executable from PATH:

gogitup remove ghorgsync --delete

Enabling GitHub Authentication

Edit ~/.gogitup and set github_auth to true to use authenticated API requests and avoid rate limits:

apps:
  - name: ghorgsync
  - name: bulkfilepr
github_auth: true

Then ensure a token is available via the GITHUB_TOKEN environment variable or the GitHub CLI (gh auth token).