# 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