1.2 KiB
1.2 KiB
name, description
| name | description |
|---|---|
| gitea-api | Read-only Gitea API queries (list org repos, inspect a repo/PR/issue, check CI runs). Use instead of hand-writing curl with tokens. GET-only and allowlisted, so it never prompts. |
Gitea API (read-only)
Run for any read query against Gitea instead of constructing curl with a token:
/root/projects/gitea-devtools/gitea-api.sh <path> | jq <filter>
Path omits the api/v1/ prefix and an optional leading /. Examples:
| Goal | Command |
|---|---|
| List org repos | gitea-api.sh /orgs/sporel/repos?limit=100 | jq -r '.[].full_name' |
| Inspect a repo | gitea-api.sh repos/calic/claude-config |
| Default branch | gitea-api.sh repos/sporel/sporel-engine | jq -r .default_branch |
| Open PRs | gitea-api.sh repos/<owner>/<name>/pulls?state=open |
| Recent CI runs | gitea-api.sh repos/<owner>/<name>/actions/tasks |
It auto-resolves a temp read-scope token via the local gitea container (or
uses $GITEA_TOKEN). GET-only — it cannot mutate anything, which is why it's
safe to run without prompting.
On ERROR: ... HTTP <code> read the hint line (401 = token/scope, 404 = path).
If a real query path is missing from this list, just use it — the script
accepts any GET path.