v2.0.0 to v2.0.0

4 added, 2 removed. Audit A to A.

---

name: forgejo-cli

- description: Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests, repositories, file contents, labels, milestones, releases, webhooks, user settings, or any /api/v1 endpoint through a safe generic API command.

+ description: 'Use when managing a Forgejo or Gitea server from the terminal: issues,

+ pull requests, repositories, file contents, labels, milestones, releases, webhooks,

+ user settings, or any /api/v1 endpoint through a safe generic API command.'

license: MIT

compatibility: Python 3.8+; requests is required only for live API calls.

metadata:

version: 2.0.0

- tags: [forgejo, gitea, git, api, code-review]

+ tags: forgejo, gitea, git, api, code-review

---

# Forgejo CLI v2

Run `python3 scripts/forgejo-cli`. `--agent` (default) uses `FORGEJO_AGENT_TOKEN`; `--user` uses `FORGEJO_USER_TOKEN`; `--server URL` selects an installation.

## Safety

- Mutations require `--force`/`--yes`/`-y`, or `--dry-run`.

- `--dry-run --json` emits one plan with `method`, `path`, `query`, and `body`; it makes no network request.

- `--json` writes exactly one JSON value to stdout; diagnostics go to stderr.

- `--help` does not read credentials or contact a server. Path segments are encoded.

## Common workflows

```bash

python3 scripts/forgejo-cli issue list --owner acme --repo app --json

python3 scripts/forgejo-cli --dry-run --json repo create --name demo --private

python3 scripts/forgejo-cli --dry-run --json api --method POST \

--path /api/v1/repos/acme/app/actions/variables --data '{"name":"KEY","value":"value"}'

```

First-class groups: `issue`, `pr`, `repo`, `content`, `label`, `milestone`, `release`, `hook`, and `user`. `content` expects base64 and update/delete require the current SHA. Use `api` for any other `/api/v1/` endpoint; it supports JSON, raw files, multipart uploads/forms, and custom headers. Consult `/api/swagger` or `/swagger.v1.json` on the selected server. See [command reference](references/command-reference.md).