refactor: lowercase Tools/Documents/Analytics folders; add clients/ and projects/ with context files; update AGENTS.md, README.md, manifest.json

2026-05-30 23:49:26 -05:00
parent 9967c6709b
commit c10598d197
14 changed files with 223 additions and 27 deletions
@@ -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