A dedicated skill for managing Forgejo instances using the tea CLI, enabling seamless interaction with PRs, issues, and Actions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install forgejo
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install forgejo using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Forgejo?
The Forgejo skill provides a robust interface for AI agents to interact with Forgejo, a self-hosted software forge. By utilizing the tea CLI, this skill allows for deep integration into version control workflows. It is a vital component of Openclaw Skills for developers who require automated repository management, including pull request handling and issue tracking without leaving their terminal or agent environment.
This skill ensures that your AI coding assistant can perform complex Git operations, query repository state, and manage CI/CD configurations directly on any Forgejo-powered server. It bridges the gap between automated coding tasks and server-side repository administration, providing a specialized toolset for the Forgejo ecosystem.
Forgejo Use Cases
- Monitoring and listing active pull requests to streamline code reviews and merges.
- Automating issue management and tracking for better project organization and bug reporting.
- Managing CI/CD pipelines by listing and updating repository secrets and variables within Forgejo Actions.
- Performing advanced data retrieval through the Forgejo API for custom reporting and integration with other tools.
How Forgejo Works
- The user installs the tea CLI on the local environment using a package manager like Homebrew or via Go modules.
- A secure connection to the Forgejo instance is established using the tea login command with a personal access token.
- The AI agent executes specific tea subcommands to fetch, create, or modify repository data such as issues or pull requests.
- For complex requirements, the skill utilizes the tea api wrapper to interact directly with the underlying REST API of the Forgejo instance.
Forgejo Setup
To begin using this skill within Openclaw Skills, you must first install the tea CLI using one of the following methods:
# Install via Homebrew
brew install tea
# Or install via Go
go install code.gitea.io/tea@latest
Once installed, configure your login credentials to connect to your Forgejo instance:
tea login add --name my-forgejo --url https://forgejo.example.com --token <your-token>
Forgejo Data Schema & Taxonomy
The skill organizes Forgejo data through the following command structure and data types:
| Category | CLI Command | Data Type Managed |
|---|---|---|
| Pull Requests | tea pulls / tea pr |
PR metadata, states, and user details. |
| Issues | tea issues / tea issue |
Issue titles, labels, and tracking IDs. |
| CI/CD | tea actions |
Repository-level secrets and environment variables. |
| API Access | tea api |
Raw JSON objects for all Forgejo REST endpoints. |
Forgejo Advanced Features
- Multi-instance support through the tea logins management system, allowing agents to switch between different Forgejo servers.
- Raw API access for retrieving specific data points not covered by standard CLI subcommands.
- Integration with jq for advanced JSON filtering and complex data transformation during API queries.
- Comprehensive CI/CD management capabilities for repository-level secrets and environment variables via Forgejo Actions.
SKILL.md
Loading
Related Openclaw Skills
Codeberg Skill
A comprehensive interface for interacting with Codeberg and Forgejo instances using the tea CLI directly within your agent workflows.
Semantic Model Orchestrator
An intelligent routing layer that analyzes query intent to select the most cost-effective and capable LLM for any given task.
Followin OpenAPI Skill
A comprehensive integration for accessing Followin's real-time Web3 information streams, trading signals, and trending crypto news.
Garmin Connect
A secure integration to sync Garmin Connect fitness metrics like steps, sleep, and workouts into your AI agent environment.
Gitea (Tea CLI)
A comprehensive interface for interacting with Gitea instances using the official tea command-line tool.
The HIVE 🐝🚀
A high-stakes collaborative knowledge exchange where AI agents answer human questions, vote on peers, and earn reputation credits.
Featured*
