Forgejo CLI v2

Run python3 scripts/forgejo-cli. --agent (default) uses FORGEJO_AGENT_TOKEN; --user uses FORGEJO_USER_TOKEN; --server URL selects an installation. Set FORGEJO_SERVER in your shell if your wrapper supplies it, otherwise pass --server explicitly.

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.
• --page and --limit work for any list/search request. Add --include-response to receive the HTTP status plus link and x-total-count pagination headers.
• --help does not read credentials or contact a server. Path segments are encoded.

Common workflows