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

CLI tool for interacting with Forgejo. Version 0.6.0 via Homebrew; verified 2026-07-19. Also installable with nix: nix profile install nixpkgs#forgejo-cli.

## 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/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:forgejo-cli
- **Package manager:** Homebrew
- **Version:** 0.6.0
- **Source summary:** CLI tool for interacting with Forgejo
- **Homepage:** <https://codeberg.org/forgejo-contrib/forgejo-cli>
- **Last updated:** 2026-07-19T08:28:20Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- fj (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.6.0
## 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

## 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.6.0-2: 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.6.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: forgejo-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI application for interacting with Forgejo | https://codeberg.org/Cyborus/forgejo-cli


## Combined YAML source

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


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
