Forgejo with orbit CLI

Manage a Forgejo (or Gitea) instance through the orbit CLI: repositories, pull requests and reviews, issues, Forgejo Actions runs and job logs, releases, and a passthrough to every other endpoint.

Prerequisites

1. orbit CLI installed - if which orbit fails, install with:
   • macOS/Linux (Homebrew): brew install jorgemuza/tap/orbit
   • macOS/Linux (script): curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh
2. A profile with a forgejo service in ~/.config/orbit/config.yaml. base_url is required - Forgejo is always self-hosted, so there is no default host.
3. A personal access token from Settings > Applications on the instance, configured as method: token. It can be an op:// or infisical:// reference.

Verify with orbit -p <profile> service ping <service-name>.

Quick Reference

All commands follow orbit -p <profile> forgejo <command> [flags], alias fj.

Repositories are always owner/repo. All list and view commands support -o json.