Initial: gitea-api (read-only) + sporel-commit tools with Claude skills

README.md

@@ -0,0 +1,53 @@
+# gitea-devtools
+
+Small dev tools for the Gitea / Sporel setup. Usable two ways:
+
+1. **Directly in a shell** (any dev environment) — clone and run the scripts.
+2. **As Claude Code skills** — `skills/` are symlinked into `~/.claude/skills/`
+   and allowlisted, so the recurring privileged chains run without per-step
+   permission prompts.
+
+## Tools
+
+### `gitea-api.sh` — read-only Gitea API helper
+
+```bash
+./gitea-api.sh /orgs/sporel/repos?limit=100 | jq '.[].full_name'
+./gitea-api.sh repos/calic/claude-config
+```
+
+GET requests only — safe to allowlist. Path may omit the leading `/` and the
+`api/v1/` prefix. Pretty-prints via `jq` if present.
+
+### `sporel-commit.sh` — multi-repo commit + push
+
+```bash
+./sporel-commit.sh --dry-run "wip"                  # preview
+./sporel-commit.sh "lib-core: bump manifests to 0.4.0"
+```
+
+Commits every **dirty** local Sporel repo with one message, using each repo's
+**own last-commit author** (Sporel repos have mixed Calic/Axel Meyer authors;
+email always `axel.meyer@durania.net`), then pushes if ahead and not diverged.
+Diverged repos are reported, never force-pushed. CI fires on tags, not master
+pushes, so WIP pushes are safe.
+
+Pair with [`sporel-sync`](https://git.davoryn.de/calic/claude-config) (in
+claude-config) which handles pull/push reconciliation.
+
+## Configuration (env vars)
+
+| Var | Default | Used by |
+|-----|---------|---------|
+| `GITEA_URL` | `http://localhost:3100` | gitea-api.sh — set to `https://git.davoryn.de` off-host |
+| `GITEA_TOKEN` | _(auto via docker `gitea` container)_ | gitea-api.sh — set this in dev environments without the container |
+| `GITEA_USER` | `calic` | gitea-api.sh |
+| `SPOREL_ROOT` | `/root/projects/Sporel` | sporel-commit.sh |
+
+In dev environments without the local `gitea` container, set `GITEA_URL` and a
+read-scope `GITEA_TOKEN`; `gitea-api.sh` then needs no docker access.
+
+## Self-maintaining
+
+On failure each script prints the error + a diagnostic hint. If the output was
+insufficient to diagnose, improve the script and push this repo.