pi-bot-01
aa39af1c66
- TOOL.md: rename PI_WEBHOOK_*/PI_BOT_POLL_* → GITEA_* throughout - TOOL.md: add gitea_edit_issue, gitea_repo_config, gitea_tracked_repos - TOOL.md: split env vars into required/tools/webhook/openclaw sections - SKILL.md: add gitea_edit_issue and management tools to quick reference - SKILL.md: add close-issue step to triage workflow - SKILL.md: add Configure Bot Behavior section - README.md: add Runtime Detection table (pi-bot vs openclaw auto-detect) - README.md: add @mention routing section - README.md: add openclaw Docker install instructions - README.md: fix auth note (GITEA_WEBHOOK_TOKEN not PI_WEBHOOK_TOKEN) - README.md: split env table into required/core/webhook/openclaw sections
102 lines
3.6 KiB
Markdown
102 lines
3.6 KiB
Markdown
---
|
|
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.
|