pi-bot-01
c07bcca417
All env vars now use GITEA_ prefix with fallback to old names: - GITEA_TOKEN (was PI_GIT_TOKEN) - GITEA_USER (was PI_GIT_USER) - GITEA_WEBHOOK_HOST/PORT/TOKEN/URL (was PI_WEBHOOK_*) - GITEA_POLL_INTERVAL (was PI_BOT_POLL_INTERVAL) - GITEA_NOTIF_INTERVAL (was PI_NOTIF_POLL_INTERVAL) - GITEA_HOOKS_URL/PATH/TOKEN (was OPENCLAW_HOOKS_*) Old names still work as fallbacks for backward compat.
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>.