It’s a Planv1.12.0

Integrations/Gitea / Forgejo

An AI agent for issues on your Gitea or Forgejo server

Point it at your own Git server. The agent lists, opens, updates and comments on issues with an access token you create.

Gitea / Forgejoabout.gitea.com

Gitea is a free, self-hosted Git service under the MIT license. Forgejo is a lightweight self-hosted forge from the Codeberg e.V. community.

Tools
4: List, create, update and comment on issues
Key
Instance URL and Access token
Edition
Free in Community
Starts on
Delegate, mention, chat or a schedule

In a run

See each call the agent makes to Gitea / Forgejo

Every Gitea / Forgejo tool call is a step of the run, with what the agent sent and what came back.

Succeeded in 33sOPS-77 Nightly backup failed on db-2
Agent
@ops · Internal
Trigger
Delegate
Started
Nov 21, 07:40
Run
#418

Result

The failure is added to the open issue #31 in infra/backups, with the log lines.

What the agent did

  1. 07:40:12get_issue{"key":"OPS-77"}
  2. 07:40:15gitea_list_issues{"owner":"infra","repo":"backups","state":"open"}
  3. 07:40:31gitea_comment_issue{"owner":"infra","repo":"backups","issue":31}
  4. 07:40:40add_comment{"issue":"OPS-77"}
  5. 07:40:45The failure is on infra/backups#31.

gitea_comment_issue07:40:31

Input{ "owner": "infra", "repo": "backups", "issue": 31, "body": "Failed again on db-2 at 02:14:\n\npg_dump: error: connection lost" }Output{ "id": 2207 }

Tools

Four Gitea and Forgejo tools for issues

The same tools work on Gitea and on Forgejo. Pull requests are not included.

List Issues

List issues in a Gitea repository.

gitea_list_issues

Create Issue

Create an issue in a Gitea repository.

gitea_create_issue

Update Issue

Update an issue in a Gitea repository: change its title or markdown body, or close and reopen it.

gitea_update_issue

Comment Issue

Comment on an issue in a Gitea repository.

gitea_comment_issue

Set up

Connect Gitea / Forgejo once for the team

  1. Create an access token

    Gitea › Settings › Applications

    Give it issue read and write. It reaches only the repositories the account can access.

  2. Add it with your server address

    Team settings › Integrations › Add credential

    Enter the address of your Gitea or Forgejo server and the token. It’s a Plan checks them before you save.

  3. Pick the tools

    Team settings › Tools › Add tool

    Add the Gitea tools for the team, then turn on the ones each agent may use.

Beacon›Add tool

Search tools

Gitea / Forgejo4 toolsSelect all
List IssuesList issues in a Gitea repository.
Create IssueCreate an issue in a Gitea repository.
Update IssueUpdate an issue in a Gitea repository: change its title or markdown body, or close and reopen it.
Comment IssueComment on an issue in a Gitea repository.
Credential

git.example.com

Add credential
3 tools selectedCancelAdd 3 tools

Use cases

Git server work you can hand an agent

Delegate

Delegate OPS-77 to @ops: it adds the failure to the open issue in infra/backups.

Mention

Mention @ops on a bug: it opens an issue in platform/api with the steps.

Column

When an issue moves to Done, @ops comments on the linked issue and closes it.

Free and Pro

Gitea / Forgejo comes with the free edition

FREE

Gitea / Forgejo and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.

PRO

HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.

See Pro
FAQ

Gitea / Forgejo AI agent FAQ

Does it work with Forgejo?

Yes. The integration works with Gitea and Forgejo servers alike.

Can it read pull requests?

No. The tools work with issues. Pull requests and branches show on an issue through the Git integration, which supports Gitea and Forgejo.

Does my Git server need to be public?

No. Your It’s a Plan server only needs to reach its address.

Does the agent see my access token?

No. It is stored encrypted on your server. The agent calls a tool by name and gets back only what the tool returns.

What does it cost?

The Gitea tools are free in the Community edition. You pay your AI provider for the model.

Connect your Git server to an agent

Try the free edition on your computer with one setup command.

Or deploy to Railway in one click

AGPL-3.0 · No per-seat fees · Use your own AI key or subscription