Gitea Repository Operations

Last verified: 2026-07-20 18:30 UTC

Status

✅ Hermes has a reusable local skill for general Gitea repository work:

Skill: gitea-repository-operations
Path: /opt/data/skills/software-development/gitea-repository-operations/SKILL.md
Scope: any organization or repository on gitea.lego-cloud.eu, not only Docusaurus projects

The existing gitea-docusaurus-projects skill remains the specialist extension for Docusaurus, pnpm, sharp-corner UI conventions, and documentation CI/CD.

Instance baseline

Capability	Configuration	Status
Web UI	`https://gitea.lego-cloud.eu`	✅
REST API	`https://gitea.lego-cloud.eu/api/v1`	✅
API credential	`/opt/data/.env` → `GITHUB_TOKEN`	✅
SSH endpoint	`ssh://git@gitea.lego-cloud.eu:30009/ORG/REPO.git`	✅
SSH identity	`/opt/data/home/.ssh/id_ed25519`	✅
Git identity	`Jarvis Jr Hermes <jarvis.at.skic@gmail.com>`	✅

Never publish the API token, embed it in a Git remote, or commit it to a repository.

Standard workflow

Authenticate with GET /api/v1/user and confirm the account is active.
Discover organization/repository metadata before mutation.
Clone via SSH with the explicit identity and BatchMode=yes.
Fetch and inspect branch divergence before editing an existing clone.
Preserve remote work; no force-push or history rewrite without explicit direction.
Run repository-specific validation and git diff --cached --check.
Commit only intended files and push through SSH.
Verify local/remote branch SHAs.
Read back a distinctive file through the authenticated Gitea API.
Report repository URL, branch, commit SHA, validation, and caveats.

Skill coverage

Organization and repository discovery/creation
Safe clone, fetch, branch, commit, and push workflow
Pagination and authenticated API usage
Collaborators with read, write, or admin permission
Issues, pull requests, releases, and tags
Gitea Actions under .gitea/workflows/
Automated no-op Git synchronization
Private-repository raw-file verification
Troubleshooting disabled accounts, SSH keys, API authorization, divergence, and CI runners

Known operational lessons

API and SSH access must be tested independently.
A successful push is not complete verification; read back the requested artifact.
Repository-level admin is not the same as organization ownership.
Private raw web links may return 404; use the authenticated API endpoint.
Gitea account disablement can break both previously valid tokens and SSH keys without requiring key/token replacement after re-enablement.
Scheduled syncs must not silently accumulate unpushed commits.

Current Gitea repositories referenced by the wiki

skic-v1-playground/knowledge-wiki — automated wiki mirror
world-v1/network-v1 — global network address book and investigation repository

Add future repository-specific details to their project documentation; keep this page focused on reusable operations.

3.0 KiB Raw Blame History