---
description: 列出 Gitea 服务器上的所有全局 Runner
---

List all global runners registered on the Gitea server.

## 工作目录

**macOS / Linux:**
```
~/.config/gitea/
```

**Windows:**
```
%USERPROFILE%\.config\gitea\
```

Please perform the following:

1. **Read Gitea configuration:**
   - Read from config file:
     - macOS/Linux: `~/.config/gitea/config.env`
     - Windows: `%USERPROFILE%\.config\gitea\config.env`
   - Extract:
     - `GITEA_URL`: Gitea server URL
     - `GITEA_TOKEN`: API token (admin permission required)
   - If config not found: prompt user to run `/gitea-reset` first

2. **Call Gitea API to list runners:**
```bash
curl -s -H "Authorization: token <token>" \
  "<server>/api/v1/admin/actions/runners"
```

3. **Parse JSON response and extract information:**
   - Response structure:
     ```json
     {
       "runners": [...],
       "total_count": 1
     }
     ```
   - Use `jq` to parse JSON
   - For each runner in `runners` array:
     - `id`: Runner ID
     - `name`: Runner name
     - `status`: Runner status ("online"/"offline")
     - `busy`: Whether runner is currently busy (true/false)
     - `ephemeral`: Whether runner is ephemeral (true/false)
     - `labels`: Array of label objects with `name` and `type`

4. **Determine runner status:**
   - 🟢 在线 - `status: "online"`
   - 🔴 离线 - `status: "offline"`
   - ⚠️ 未知 - Unable to determine

5. **Filter global runners:**
   - The API endpoint `/api/v1/admin/actions/runners` returns all global runners
   - These are runners registered at the instance level (not org or repo specific)

6. **Display summary in Chinese:**
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Gitea 全局 Runners
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

服务器: [server_url]
总计:   N 个全局 runner

[runner-name]
  状态:       🟢/🔴 [在线/离线]
  ID:         [id]
  忙碌:       是/否
  临时:       是/否
  标签:       [comma-separated labels]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
管理命令
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  查看配置:    /gitea-config
  创建 runner: /gitea-create-runner
  删除 runner: /gitea-delete-runner
```

**Notes:**
- Requires admin API token to list runners
- **Correct API endpoint**: `/api/v1/admin/actions/runners` (not `/api/v1/admin/runners`)
- Only shows global runners (instance-level runners)
- Uses `jq` for JSON parsing
- Response includes: `id`, `name`, `status`, `busy`, `ephemeral`, `labels`
- If API call fails, show error message and suggest checking token permissions
- Tested with Gitea version 1.25.3