feat: add local Gitea CLI helper

README.md

@@ -0,0 +1,32 @@
+# gitea-cli
+
+Tiny stdlib-only Python helper for common operations against the local self-hosted Gitea instance.
+
+Defaults:
+
+- `GITEA_URL=http://192.168.33.22:3300`
+- `GITEA_USER=gemma`
+
+Credentials are read at runtime from:
+
+1. `GITEA_TOKEN`
+2. `GITEA_PASSWORD`
+3. `/root/PASSWORD.md` line matching `gitea <password>`
+
+## Install
+
+```bash
+sudo install -m 0755 gitea-cli /usr/local/bin/gitea-cli
+sudo ln -sf /usr/local/bin/gitea-cli /usr/local/bin/gitea
+```
+
+## Usage
+
+```bash
+gitea version
+gitea list
+gitea list --json
+gitea get arcana-fx
+gitea create my-repo --description "description" --private
+gitea create my-repo --dry-run
+```