---
name: gitea
description: Interact with Gitea repositories, issues, PRs, CI runs, and files via git.dominat.us. Use when working with Gitea repos, triaging issues, reviewing PRs, checking CI logs, creating branches, updating files, managing webhooks, or configuring bot response behavior.
---

# Gitea

Tools for interacting with a Gitea instance (git.dominat.us by default).

## When to Use

- Listing, viewing, or searching repositories
- Reading or triaging issues
- Reviewing or creating pull requests
- Checking CI workflow runs and logs
- Reading or updating files in a repo via the API
- Creating branches for feature work
- Setting up webhooks for event notifications
- Configuring which repos the bot monitors and how it responds

## Quick Reference

See [TOOL.md](TOOL.md) for full parameter details on every tool.

### Read Operations

| Tool | Purpose |
|------|---------|
| `gitea_list_repos` | List repos (yours or another owner's) |
| `gitea_list_issues` | List issues on a repo |
| `gitea_get_issue` | Get issue details + comments |
| `gitea_list_prs` | List pull requests |
| `gitea_get_pr` | Get PR details + comments |
| `gitea_list_runs` | List CI workflow runs |
| `gitea_get_run_logs` | Get full CI logs for a run |
| `gitea_get_file_content` | Read a file from a repo |

### Write Operations

| Tool | Purpose |
|------|---------|
| `gitea_create_repo` | Create a new repository |
| `gitea_ensure_repo` | Get or create a repository |
| `gitea_create_issue` | Open a new issue |
| `gitea_create_issue_comment` | Comment on an issue or PR |
| `gitea_edit_issue` | Change title, body, or state of an issue |
| `gitea_create_branch` | Create a branch |
| `gitea_update_file` | Create or update a file (handles new vs existing automatically) |
| `gitea_create_pr` | Open a pull request |
| `gitea_merge_pr` | Merge a pull request |
| `gitea_create_webhook` | Add a webhook to a repo |

### Management

| Tool | Purpose |
|------|---------|
| `gitea_repo_config` | Set per-repo response mode (`"all"` or `"mention"`) |
| `gitea_tracked_repos` | List all tracked repos with type and response mode |

## Common Workflows

### Triage an Issue

1. `gitea_list_issues` to see open issues
2. `gitea_get_issue` to read details and comments
3. `gitea_create_issue_comment` to respond
4. `gitea_edit_issue` with `state: "closed"` when resolved

### Fix an Issue via PR

1. `gitea_get_issue` to understand the problem
2. `gitea_create_branch` to create a feature branch
3. `gitea_get_file_content` to read the file(s) that need fixing (saves the SHA)
4. `gitea_update_file` to push the fix on the feature branch (pass the SHA for existing files)
5. `gitea_create_pr` to open a PR referencing the issue
6. `gitea_edit_issue` with `state: "closed"` to close the issue

### Check CI Status

1. `gitea_list_runs` to see recent workflow runs
2. `gitea_get_run_logs` to read logs for a failing run

### Configure Bot Behavior

- `gitea_tracked_repos` — see what the bot is monitoring
- `gitea_repo_config repo="owner/name" respondTo="all"` — respond to all events on this repo
- `gitea_repo_config repo="owner/name" respondTo="mention"` — only respond when @mentioned

## Configuration

| Variable | Purpose | Default |
|----------|---------|---------|
| `GITEA_URL` | Gitea instance URL | `https://git.dominat.us` |
| `GITEA_TOKEN` | API token (required) | — |
| `GITEA_USER` | Bot's own username | — |
| `GITEA_OWNER` | Default repo owner | — |
| `GITEA_REPO` | Default repo name | — |

Most tools accept `owner` and `repo` parameters to override defaults per-call.

See [TOOL.md](TOOL.md) for the full environment variable reference including webhook server and openclaw hooks settings.