From b0916e3f096e7b39e691a613c8612e92d41b8543 Mon Sep 17 00:00:00 2001
From: Jacob Mathison <jacob@mathisonprojects.com>
Date: Sat, 30 May 2026 23:15:49 -0500
Subject: [PATCH] init: add Gitea access guide for LLM tools
 (Codex/Claude/Cursor)

---
 gitea.llm.md | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 gitea.llm.md

diff --git a/gitea.llm.md b/gitea.llm.md
new file mode 100644
index 0000000..64b8f41
--- /dev/null
+++ b/gitea.llm.md
@@ -0,0 +1,121 @@
+# Accessing This Local Gitea Instance
+
+This project lives on a self-hosted [Gitea](https://gitea.io) instance running on the local network / Tailscale.
+
+---
+
+## 📍 Instance Details
+
+| Field | Value |
+|-------|-------|
+| **Web UI** | http://100.79.253.19:3000 |
+| **Tailscale hostname** | `Orson` / `Hagia` / `Theodora` (all resolve to `100.79.253.19`) |
+| **Owner** | `jacob-mathison` |
+| **Gitea version** | 1.26.2 |
+
+---
+
+## 🔗 Cloning This Repo
+
+```bash
+# HTTPS (recommended for Codex / Claude / Cursor)
+git clone http://100.79.253.19:3000/jacob-mathison/llm-tools.git
+
+# SSH (if your SSH key is registered in Gitea)
+git clone orson@100.79.253.19:jacob-mathison/llm-tools.git
+```
+
+---
+
+## 🔑 Authentication
+
+### Personal Access Token (PAT)
+Generate one at: **http://100.79.253.19:3000/user/settings/applications**
+
+Required scopes: `read:repository`, `write:repository`
+
+Once generated, configure git to use it:
+```bash
+git config credential.helper store
+# Then push/pull once — it will prompt for username + PAT
+```
+
+Or embed in the remote URL (one-time use, avoid committing):
+```bash
+git clone http://jacob-mathison:<YOUR_PAT>@100.79.253.19:3000/jacob-mathison/llm-tools.git
+```
+
+### For CI / Automated Tools
+Set these environment variables:
+```bash
+export GITEA_URL=http://100.79.253.19:3000
+export GITEA_USER=jacob-mathison
+export GITEA_TOKEN=<your-pat>
+```
+
+---
+
+## 🤖 For Codex / Claude / Cursor
+
+### If running on the same Tailscale network:
+The Gitea instance is directly reachable at `http://100.79.253.19:3000`. No tunnel needed.
+
+```bash
+# Verify reachability
+curl -s http://100.79.253.19:3000/api/v1/version
+# Should return: {"version":"1.26.2"}
+```
+
+### Git config for this remote
+```bash
+git remote add origin http://100.79.253.19:3000/jacob-mathison/llm-tools.git
+git remote set-url origin http://jacob-mathison:<YOUR_PAT>@100.79.253.19:3000/jacob-mathison/llm-tools.git
+```
+
+### Pushing changes
+```bash
+git add .
+git commit -m "your message"
+git push origin main
+```
+
+---
+
+## 📋 Gitea API Quick Reference
+
+All API calls use Basic Auth or Bearer token:
+
+```bash
+# List repos
+curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/search | jq '.data[].full_name'
+
+# Get repo info
+curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools
+
+# Create a file
+curl -s -u jacob-mathison:<PAT> -X POST \
+  http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools/contents/example.md \
+  -H "Content-Type: application/json" \
+  -d '{"message":"add file","content":"'$(echo 'Hello' | base64)'"}'
+
+# List branches
+curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools/branches
+
+# Full API docs (Swagger)
+http://100.79.253.19:3000/api/swagger
+```
+
+---
+
+## 🏗️ Repository List
+
+Browse all repos: **http://100.79.253.19:3000/jacob-mathison**
+
+---
+
+## ⚠️ Network Notes
+
+- **On local LAN:** The machine hosting Gitea is accessible via LAN at the same `100.79.253.19` Tailscale IP
+- **Off-network:** Must be on Tailscale VPN to reach this instance
+- **Tailscale install:** https://tailscale.com/download — ask Jacob for an invite if needed
+- **Port 3000** must not be firewalled if accessing from another LAN machine