Stephen Way
495276f654
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>
45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# fj
|
|
|
|
A command-line tool for [Forgejo](https://forgejo.org) instances, in the spirit of GitHub's `gh`.
|
|
|
|
Multi-host from day one. Tokens are stored in your OS keychain.
|
|
|
|
## Install
|
|
|
|
```sh
|
|
cargo install --path .
|
|
```
|
|
|
|
## Quick start
|
|
|
|
```sh
|
|
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
|