ceven

Gitea

Syncs your self hosted code repositories with project management tools, automates repository setup for new clients, and monitors server versioning for compliance.

Try Gitea in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Gitea integration

    • Describe the outcome and Ceven picks the right Gitea calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Gitea data, across all 19 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Gitea access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Gitea, when, and on whose behalf.
    • The agent pauses and asks when Gitea is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Gitea.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Gitea action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Gitea, and when to use it.

Get ActivityPub Person
Pull the ActivityPub representation of a user for federation or ActivityStreams data.
Get API Settings
Retrieve global API settings to check pagination limits and response size constraints.
Get Attachment Settings
Pull global settings for file attachments including allowed types and size limits.
Get Repository Settings
Check global flags for mirroring, LFS, and time tracking to see what features are active.
Get UI Settings
Retrieve the default theme and allowed reactions configured for the Gitea interface.
Get Gitignore Template
Pull the content of a specific gitignore template for use in new repository setup.
Get Label Template
Retrieve all labels from a specific template to standardize issue tracking.
Get License Template
Pull the content and details of a specific license template for legal compliance.
Get Node Info
Retrieve standardized metadata about the Gitea server following the NodeInfo spec.
Get Signing Key
Pull the default GPG signing key to verify commits signed by the Gitea instance.
Get Version
Check the current version of the Gitea application for update tracking.
List All Organizations
Retrieve a paginated list of every organization registered on the Gitea instance.
List Org Secrets
List all action secrets for an organization to verify their existence without seeing values.
Render Markdown
Convert a markdown document into HTML using specific context modes like wiki or comment.
Render Markup
Convert markup formats like AsciiDoc or Markdown into HTML for external display.
List License Templates
Pull all available license templates to offer a choice during repo creation.
Get ActivityPub Person Actor
Tool to retrieve the ActivityPub Person actor for a Gitea user. Use when you need to fetch a user's ActivityPub representation for federation purposes or to get ActivityStreams formatted user data.
Get General API Settings
Tool to retrieve the Gitea instance's global API settings including pagination limits and response size constraints. Use when you need to understand API rate limits or configuration parameters.
Get General Attachment Settings
Tool to retrieve the Gitea instance's global settings for file attachments including enabled status, allowed file types, size limits, and file count limits. Use when you need to understand the attachment configuration of the instance.
Get General Repository Settings
Tool to retrieve the Gitea instance's global settings for repositories including feature flags for mirroring, HTTP Git, migrations, stars, time tracking, and LFS. Use when you need to understand which repository features are enabled or disa
Get General UI Settings
Tool to retrieve the Gitea instance's global settings for UI including default theme, allowed reactions, and custom emojis. Use when you need to understand the UI configuration of the instance.
Get Gitignore Template Info
Tool to retrieve information about a specific gitignore template. Use when you need the content of a gitignore template for repository creation or configuration.
Get Label Template Info
Tool to retrieve all labels from a specific label template. Use when you need to view the predefined label set for repository configuration.
Get License Template Info
Tool to retrieve information about a specific license template. Use when you need the content and details of a license template for repository creation or configuration.
List Gitignore Templates
Tool to retrieve all available gitignore templates. Use when creating a repository to select an appropriate .gitignore template.
List Label Templates
Tool to retrieve all available label templates. Use when you need to discover which predefined label sets are available for repositories.
Get All Organizations
Tool to retrieve a paginated list of all organizations in the Gitea instance. Use when you need to list all organizations or browse organizations with pagination support.
List Organization Actions Secrets
Tool to list all action secrets for an organization. Use when you need to retrieve the list of secrets configured at the organization level. Note that secret values are never returned through the API for security purposes.
Render Markdown Raw
Tool to render raw markdown text as HTML. Use when you need to convert markdown content to HTML format for display or processing.

29 actions · scroll to see them all

Frequently asked questions

Ceven connects to your Gitea instance using a personal access token. You generate this token within your Gitea user settings under the applications section. Once you provide the token to Ceven, the agent includes it in the authorization header of every API request. We store this token using AES 256 encryption at rest. Because Gitea is often self hosted, you must ensure your firewall allows incoming traffic from Ceven IP addresses. You can revoke the token at any time from your Gitea dashboard, which immediately kills all active agent sessions and prevents further access to your code or organization data.
No. The Gitea API is designed so that secret values are write only. When Ceven calls the list organization secrets endpoint, Gitea returns the names and metadata of the secrets but never the decrypted values themselves. This means the agent can tell you that a secret named AWS ACCESS KEY exists and when it was last updated, but it can never read the key or leak it into a workflow. This security boundary is enforced by Gitea and cannot be bypassed by the Ceven agent regardless of the token permissions granted during the initial setup process.
Ceven handles rate limits by respecting the headers returned by your Gitea server. If the server sends a 429 Too Many Requests response, the agent enters a backoff loop. It reads the retry after header to determine exactly when to attempt the call again. For very large instances with thousands of repositories, we use paginated requests to avoid hitting memory limits or triggering DDoS protections on your server. If you find the agent is hitting limits too often, we recommend adjusting the global API settings in your Gitea admin panel to increase the allowed request frequency for your token.
Ceven is built to work with the latest stable releases of Gitea. We use the Get Version tool to check your instance version before running complex workflows. If your instance is running a version that is significantly outdated and missing key API endpoints, the agent will notify you that certain capabilities are unavailable. One specific quirk of older Gitea versions is the inconsistent handling of pagination cursors in organization lists. To solve this, the agent uses a fallback looping mechanism for versions prior to the current stable branch to ensure no data is missed during an audit.
Yes. By combining the Get Gitignore Template and Get License Template tools, the agent can gather all the necessary configuration files first. It then uses the write actions to provision the repository with the correct settings. This allows you to build a workflow where a form submission in your internal portal triggers the creation of a Gitea repo with a specific license, a standard.gitignore, and a set of predefined labels. This ensures that every project in your organization follows the same structure from the very first commit without needing a human to click through the UI.
The Render Markdown tool sends raw text to the Gitea API, which then processes it using the server side rendering engine. This is useful because it ensures that the HTML produced by Ceven is identical to how it would appear inside the Gitea web interface. This is critical for generating automated reports or documentation pages that need to maintain consistent styling. You can specify the context, such as whether the text is a comment or a wiki page, so that the renderer applies the correct formatting rules and link resolutions specific to that part of the Gitea platform.
Yes. The agent can pull the full list of organizations and then query the membership of each. Using the ActivityPub Person tool, it can even resolve identity data for users in a federated environment. This allows you to create a master user directory in a tool like Airtable and have the agent automatically sync those users into the correct Gitea organizations. If a user is removed from your HR system, the agent can trigger a workflow to remove them from all Gitea orgs and revoke their access tokens, ensuring that your self hosted code remains secure.
There is no hard limit on the number of templates the agent can retrieve, but it is subject to the general API timeout settings of your Gitea instance. When listing all license or gitignore templates, the agent receives a JSON array. For most installations, this is a small payload. However, if you have added hundreds of custom templates, the agent will process them in chunks. Because Gitea is lightweight, these calls are usually very fast, but we recommend using specific template names whenever possible to reduce the load on your server during high frequency automation runs.

Alternatives to Gitea

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

GitHub logoGitHubGitLab logoGitLabBitbucket logoBitbucket

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Gitea and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free