# Install forgejo-cli with Homebrew, Nix, pacman, zypper

CLI tool for interacting with Forgejo. Version 0.5.0 via Homebrew; verified 2026-04-17.

## Install

```sh
sudo av install brew:forgejo-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install forgejo-cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#forgejo-cli
```

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

- pacman (92%):

```sh
sudo pacman -S forgejo-cli
```

  Evidence: Arch Linux sync databases: forgejo-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install forgejo-cli
```

  Evidence: openSUSE Tumbleweed package metadata: forgejo-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:forgejo-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/forgejo-cli>
- **Version:** 0.5.0
- **Source summary:** CLI tool for interacting with Forgejo
- **Homepage:** <https://codeberg.org/forgejo-contrib/forgejo-cli>
- **Repository:** <https://codeberg.org/forgejo-contrib/forgejo-cli>
- **Upstream docs:** <https://codeberg.org/forgejo-contrib/forgejo-cli>
- **License:** Apache-2.0 OR MIT
- **Source archive:** <https://codeberg.org/forgejo-contrib/forgejo-cli/archive/v0.5.0.tar.gz>
- **Last updated:** 2026-04-17T04:02:07Z
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- fj (cli)
- fj (alias)

## Dependencies

- openssl@3

## Build dependencies

- pkgconf
- rust

## 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-09
- Package-manager version: 0.5.0
- Package-manager updated: 2026-04-17
- Local data: ok
- Upstream repository: https://codeberg.org/forgejo-contrib/forgejo-cli
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Forgejo CLI is fj, a command-line client for interacting with Forgejo instances. The README positions it as analogous to gh, glab, or tea, but for Forgejo.

### Project history

The official Codeberg repository was created in July 2023 under forgejo-contrib. Its README describes a CLI that handles Forgejo-specific tasks alongside, rather than replacing, git.

The project provides commands for issues, pull requests, repositories, organizations, teams, stars, watches, and releases, and points users to its Codeberg wiki for installation and usage details.

### Adoption history

Forgejo CLI followed Forgejo's emergence as an independent software forge by filling the ecosystem gap for a first-class terminal client.

The release API shows early 0.0.x releases in January 2024, v0.1.0 in August 2024, and continued releases through v0.5.0 in April 2026.

### How it is used

Users install prebuilt binaries from the Codeberg releases tab or package-manager builds, then use fj to open, edit, comment on, close issues, create and merge pull requests, manage repositories and teams, and publish releases.

The README explicitly says fj is not meant to replace git; it covers Forgejo API and hosting workflows that git itself does not handle.

### Why package nerds care

Forgejo CLI matters because every forge tends to accumulate a native command-line client: gh for GitHub, glab for GitLab, tea for Gitea, and fj for Forgejo.

For package indexes, it is a good example of an ecosystem companion package whose identity is tied to a host application's API rather than to a standalone file format or runtime.

### Timeline

- 2023: The forgejo-contrib/forgejo-cli repository is created on Codeberg.
- 2024: v0.0.2 and v0.0.3 are published in January.
- 2024: v0.1.0 is published in August.
- 2025: v0.3.0 is published in May.
- 2026: v0.5.0 is published in April.

### Related projects

- Forgejo CLI is related to Forgejo itself and to other forge CLIs named by its README: GitHub CLI gh, GitLab CLI glab, and Gitea's tea.
- It is hosted under forgejo-contrib, alongside other community-maintained Forgejo ecosystem projects.

### Sources

- <https://codeberg.org/api/v1/repos/forgejo-contrib/forgejo-cli>
- <https://codeberg.org/api/v1/repos/forgejo-contrib/forgejo-cli/releases?limit=10>
- <https://codeberg.org/forgejo-contrib/forgejo-cli>
- <https://codeberg.org/forgejo-contrib/forgejo-cli/raw/branch/main/README.md>
- <https://codeberg.org/forgejo-contrib/forgejo-cli/wiki/Installation>


## Security Notes

narrow executable package without higher-risk signals.

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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** forgejo-cli
- **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

- Nix - forgejo-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/fo/forgejo-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - forgejo-cli - 0.5.0-1: normalized package name match | Arch Linux sync databases: forgejo-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | CLI application for interacting with Forgejo | https://codeberg.org/forgejo-contrib/forgejo-cli
- zypper - forgejo-cli - 0.5.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: forgejo-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CLI application for interacting with Forgejo | https://codeberg.org/Cyborus/forgejo-cli


## 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.
- [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.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [forgejo](https://www.automicvault.com/pkg/brew/forgejo/) - Package name indicates the same formula family.
- [codeberg-cli](https://www.automicvault.com/pkg/brew/codeberg-cli/) - Shares av.db curated category or tags: cli, codeberg, developer-tools, git, version-control.
- [gcli](https://www.automicvault.com/pkg/brew/gcli/) - Shares av.db curated category or tags: cli, developer-tools, forgejo, git, version-control.
- [git-pages](https://www.automicvault.com/pkg/brew/git-pages/) - Shares av.db curated category or tags: cli, developer-tools, forgejo, git, version-control.
- [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [aicommit2](https://www.automicvault.com/pkg/brew/aicommit2/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [aicommits](https://www.automicvault.com/pkg/brew/aicommits/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [braid](https://www.automicvault.com/pkg/brew/braid/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [cig](https://www.automicvault.com/pkg/brew/cig/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [git-pages-cli](https://www.automicvault.com/pkg/brew/git-pages-cli/) - Local package facts share a topical domain. Shared terms: cli, codeberg, developer, developer-tools, forgejo.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
