A command-line tool for Forgejo instances.

Find a file

Stephen Way 495276f654 initial: fj, a CLI for Forgejo Multi-host auth (tokens in OS keychain), repo/issue/pr CRUD, and a gh-style `api` escape hatch with -f/-F/-X/-q. Targets Forgejo 7.x via the Gitea-compatible /api/v1 surface. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-05-13 07:56:28 -07:00
src	initial: fj, a CLI for Forgejo	2026-05-13 07:56:28 -07:00
.gitignore	initial: fj, a CLI for Forgejo	2026-05-13 07:56:28 -07:00
Cargo.lock	initial: fj, a CLI for Forgejo	2026-05-13 07:56:28 -07:00
Cargo.toml	initial: fj, a CLI for Forgejo	2026-05-13 07:56:28 -07:00
README.md	initial: fj, a CLI for Forgejo	2026-05-13 07:56:28 -07:00

README.md

fj

A command-line tool for Forgejo instances, in the spirit of GitHub's gh.

Multi-host from day one. Tokens are stored in your OS keychain.

Install

cargo install --path .

Quick start

fj auth login                          # add a host and token
fj auth status                         # show signed-in hosts
fj repo list                           # repos you own on the default host
fj repo view owner/name                # repo overview
fj issue list -R owner/name            # issues
fj pr list -R owner/name --state open  # pull requests
fj api /repos/search?q=foo             # raw API escape hatch

Use --host <hostname> on any command to target a specific host.

Commands

Group	Commands
`auth`	`login`, `status`, `logout`, `list`, `switch`
`repo`	`list`, `view`, `clone`, `create`
`issue`	`list`, `view`, `create`, `close`, `reopen`, `comment`
`pr`	`list`, `view`, `create`, `checkout`, `merge`, `close`
`api`	raw HTTP against `/api/v1` with optional fields and jq-style field selection

Config

Hosts and the current host live in $XDG_CONFIG_HOME/fj/hosts.toml (~/Library/Application Support/fj/hosts.toml on macOS).
Tokens live in the OS keychain under service fj keyed by hostname.

License

MIT