# Install gcli with Homebrew, apk, apt, MacPorts, Nix

Portable Git(hub|lab|tea)/Forgejo/Bugzilla CLI tool. Version 2.12.0 via Homebrew; verified 2026-05-30.

## Install

```sh
sudo av install brew:gcli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gcli
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gcli
```

  Evidence: MacPorts ports tree: devel/gcli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add gcli
```

  Evidence: Alpine Linux edge package indexes: gcli from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install gcli
```

  Evidence: Debian stable package indexes: gcli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#gcli
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gc/gcli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:gcli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gcli>
- **Version:** 2.12.0
- **Source summary:** Portable Git(hub|lab|tea)/Forgejo/Bugzilla CLI tool
- **Homepage:** <https://herrhotzenplotz.de/gcli/>
- **Repository:** <https://github.com/herrhotzenplotz/gcli>
- **Upstream docs:** <https://herrhotzenplotz.de/gcli>
- **License:** BSD-2-Clause
- **Source archive:** <https://github.com/herrhotzenplotz/gcli/archive/refs/tags/v2.12.0.tar.gz>
- **Last updated:** 2026-05-30T14:50:47Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gcli (cli)
- gcli (alias)

## Dependencies

- lowdown
- openssl@3

## Build dependencies

- pkgconf
- readline

## Uses from macOS

- curl
- libedit

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.12.0
- Package-manager updated: 2026-05-30
- Local data: ok
- Upstream repository: https://github.com/herrhotzenplotz/gcli
- Upstream latest detected: v2.12.0 (current)
## Project history and usage

GCLI is a portable command-line client for working with multiple software forges through one interface. Its README frames the project as an answer to single-forge tools: instead of remembering separate commands for GitHub, GitLab, Gitea, Forgejo, and Bugzilla, GCLI presents a shared CLI.

### Project history

The public GitHub repository was created in October 2021, while the project homepage and README both point to Sourcehut, GitLab, and GitHub development surfaces. The project is written as a small, portable C tool with few dependencies, manual pages, built-in help, and support for scripted and interactive use.

### Adoption history

The project homepage says GCLI is available in various distributions and asks users to submit packages for their preferred operating systems. The README lists tested systems across BSDs, Solaris and OmniOS, Debian and Devuan, Gentoo, Fedora, Alpine, Haiku, Minix, Darwin, and Windows/MSYS2, which signals a portability-first package culture.

### How it is used

GCLI manages issues, merge requests, continuous integration, releases, and milestones from the terminal. It also integrates with Git and GoT, and its preferred contribution workflow is mailing-list based, with GitLab and GitHub mirrors accepted as alternatives.

### Why package nerds care

GCLI is interesting because it deliberately avoids the modern pattern of one CLI per forge. For package maintainers, the notable traits are the C implementation, small dependency set, manual-page documentation, broad Unix portability testing, and explicit support for old-school email patch workflows.

### Timeline

- 2021: GitHub records the public GCLI repository creation.
- 2024: The official release archive contains the 1.0 and 2.x release series.
- 2026: The release archive lists 2.12.0, and the repository remained active in June 2026.

### Related projects

- GitHub CLI is named by the README as the single-forge contrast that motivated GCLI.
- GitLab, Gitea, Forgejo, GitHub, and Bugzilla are supported services.
- Git and GoT are supported version-control integrations.

### Sources

- <https://api.github.com/repos/herrhotzenplotz/gcli>
- <https://github.com/herrhotzenplotz/gcli>
- <https://herrhotzenplotz.de/gcli>
- <https://herrhotzenplotz.de/gcli/releases/>
- <https://raw.githubusercontent.com/herrhotzenplotz/gcli/master/README.md>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/gcli/config

## Credential files

- Unix: ~/.config/gcli/config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gcli
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - gcli - 2.3.0-1: normalized package name match | Debian stable package indexes: gcli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Git Forge CLI | https://herrhotzenplotz.de/gcli/
- Nix - gcli: normalized package name match | nixpkgs package indexes: pkgs/by-name/gc/gcli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - gcli - 2.2.0-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: gcli from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Git Forge CLI | https://herrhotzenplotz.de/gcli/
- apk - gcli - 2.9.1-r1: normalized package name match | Alpine Linux edge package indexes: gcli from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable GitHub/GitLab/Gitea CLI tool | https://herrhotzenplotz.de/gcli/
- apk - gcli-doc - 2.9.1-r1: normalized package name match | Alpine Linux edge package indexes: gcli-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable GitHub/GitLab/Gitea CLI tool (documentation) | https://herrhotzenplotz.de/gcli/
- MacPorts - gcli: normalized package name match | MacPorts ports tree: devel/gcli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [lowdown](https://www.automicvault.com/pkg/brew/lowdown/) - Runtime dependency declared by Homebrew.
- [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [git-spice](https://www.automicvault.com/pkg/brew/git-spice/) - Shares av.db curated category or tags: cli, developer-tools, git, github, gitlab.
- [gitbackup](https://www.automicvault.com/pkg/brew/gitbackup/) - Shares av.db curated category or tags: cli, developer-tools, git, github, gitlab.
- [hub](https://www.automicvault.com/pkg/brew/hub/) - Shares av.db curated category or tags: cli, developer-tools, git, github, version-control.
- [lab](https://www.automicvault.com/pkg/brew/lab/) - Shares av.db curated category or tags: cli, developer-tools, git, gitlab, version-control.
- [microplane](https://www.automicvault.com/pkg/brew/microplane/) - Shares av.db curated category or tags: cli, developer-tools, git, github, gitlab.
- [sugarjar](https://www.automicvault.com/pkg/brew/sugarjar/) - Shares av.db curated category or tags: cli, developer-tools, git, github, version-control.
- [braid](https://www.automicvault.com/pkg/brew/braid/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [codeberg-cli](https://www.automicvault.com/pkg/brew/codeberg-cli/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [dura](https://www.automicvault.com/pkg/brew/dura/) - Local package facts share a topical domain. Shared terms: cli, control, developer, developer-tools, git.
- [git-series](https://www.automicvault.com/pkg/brew/git-series/) - Local package facts share a topical domain. Shared terms: cli, control, developer, developer-tools, git.
- [gitnr](https://www.automicvault.com/pkg/brew/gitnr/) - Local package facts share a topical domain. Shared terms: cli, control, developer, developer-tools, git.

## Combined YAML source

View the package source record on GitHub. [combined/gcli.yml](https://github.com/automic-vault/db/blob/main/combined/gcli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
