Accessing This Local Gitea Instance

This project lives on a self-hosted Gitea 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

# 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:

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):

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:

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.

# Verify reachability
curl -s http://100.79.253.19:3000/api/v1/version
# Should return: {"version":"1.26.2"}

Git config for this remote

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

git add .
git commit -m "your message"
git push origin main

📋 Gitea API Quick Reference

All API calls use Basic Auth or Bearer token:

# 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

3.2 KiB Raw Permalink Blame History