forgejo-cli

Manages Forgejo and Gitea resources via authenticated command-line interface.

40|6|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/magnus919/agent-skills --skill forgejo-cli-magnus919
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forgejo-cli
Source: https://github.com/magnus919/agent-skills/tree/main/forgejo-cli
Command: npx skills add https://github.com/magnus919/agent-skills --skill forgejo-cli-magnus919

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides a secure, predictable interface for managing Forgejo or Gitea servers, preventing accidental mutations and ensuring machine-readable output for complex repository workflows.

Core Features & Use Cases

  • Guarded API Operations: Execute repository, issue, and pull request management with built-in safety checks like dry-runs and mandatory force flags for mutations.
  • Generic API Escape Hatch: Access any version-specific /api/v1/ endpoint safely using the generic client, supporting JSON, multipart uploads, and custom headers.
  • Use Case: Automate the creation of release assets or bulk-update repository labels across multiple projects while maintaining a clear audit trail of the planned changes.

Quick Start

Use the forgejo-cli skill to list all open issues for the repository acme/app and output the results as machine-readable JSON.

Frequently Asked Questions about forgejo-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Forgejo API calls safely without accidentally modifying repository data?

Automate Forgejo API calls safely by using a command-line interface that enforces safety protocols, including dry-run planning and mandatory force flags for state-changing operations on issues and pull requests.

Can I get machine-readable JSON output for Gitea issues and pull requests?

Yes, you can retrieve machine-readable JSON output for Gitea issues and pull requests by executing guarded API interactions that structure repository metadata into predictable data formats for complex workflows.

What is the best way to access version-specific Gitea API endpoints for bulk repository administration?

Access version-specific Gitea API endpoints using a generic client escape hatch that safely handles custom headers, multipart uploads, and JSON payloads for bulk repository administration tasks.

Do I need Python and the requests library to manage Forgejo servers via command line?

Yes, you need Python 3.8 or higher and the requests library to perform authenticated API interactions and manage Forgejo server resources through the command-line interface.

How do I perform a dry-run for bulk-updating repository labels across multiple Gitea projects?

Perform a dry-run for bulk-updating repository labels by executing guarded API operations that plan and audit state-changing mutations before they are applied across multiple Gitea projects.