pi-bot-01
b868ad4df5
- files.ts: Use POST for new files, PUT for updates (Gitea 1.25 requires this) - issues.ts: Add editIssue() for state/title/body changes - write-tools.ts: Add gitea_edit_issue tool (open/close/edit issues) - webhook/server.ts: Persist lastPollAt to disk to prevent duplicate events on reload; use followUp delivery to queue events during LLM turns - index.ts: Use deliverAs:'followUp' for sendUserMessage
gitea
Consolidated Gitea API client and pi extension for git.dominat.us.
Provides a pure TypeScript Gitea API client (no external dependencies), a pi extension that registers tools for LLM use, and a standalone CLI.
Structure
src/ Core API client (pure fetch, token auth, zero deps)
pi-extension/ Pi extension adapter (registers tools + webhook server)
cli.ts Standalone CLI
SKILL.md Agent skill definition (auto-discovered by pi)
TOOL.md Tool reference documentation
Installation
As a pi extension
Add to your settings.json:
{
"packages": ["/path/to/gitea/pi-extension"]
}
Or place/symlink pi-extension/ into your <agentDir>/extensions/ directory.
As a library
import { GiteaClient, listRepos, getIssue } from "./src/index.js";
const client = new GiteaClient({
url: "https://git.dominat.us",
token: "your-token",
});
const repos = await listRepos(client);
const issue = await getIssue(client, "owner", "repo", 1);
As a CLI
export GITEA_TOKEN="your-token"
npx tsx cli.ts whoami
npx tsx cli.ts repos
npx tsx cli.ts issues owner/repo
npx tsx cli.ts create-issue owner/repo "Bug title" --body "Description"
Configuration
| Variable | Purpose | Default |
|---|---|---|
GITEA_URL |
Gitea instance URL | https://git.dominat.us |
GITEA_TOKEN |
API token (required) | — |
GITEA_OWNER |
Default repo owner | — |
GITEA_REPO |
Default repo name | — |
See TOOL.md for full tool documentation and SKILL.md for the agent skill definition.
Auth
All API calls use Authorization: token <GITEA_TOKEN> header. No HMAC secrets.
Webhook endpoint optionally validates with Authorization: Bearer <PI_WEBHOOK_TOKEN>.