# llm-tools

This repository contains tooling, guides, and configuration resources for LLM agents (Codex, Claude, Cursor, etc.) working in Jacob Mathison's development environment.

## What is this repo for?

Developers and AI coding agents who need to:
- Access the local self-hosted Gitea instance
- Understand the project layout and available repositories
- Bootstrap themselves into the local dev environment

## Local Gitea Instance

A self-hosted Gitea (v1.26.2) runs on the local Tailscale network:

  URL:    http://100.79.253.19:3000
  Owner:  jacob-mathison
  Access: Tailscale VPN required (ask Jacob for an invite)

To verify connectivity:
  curl -s http://100.79.253.19:3000/api/v1/version

To clone any repo:
  git clone http://100.79.253.19:3000/jacob-mathison/<repo-name>.git

To authenticate, generate a Personal Access Token at:
  http://100.79.253.19:3000/user/settings/applications

## Files in This Repo

  README.md        Human + AI overview, quick-start, and conventions.
  llm.txt          This file. Plain-text overview for LLM agents.
  manifest.json    Machine-readable index of repos, tools, and endpoints.
  gitea.llm.md     Local Gitea instance — clone URLs, PAT auth, API examples.
  github.llm.md    GitHub accounts (MathisonProjects, silmaai) — repos, PAT, CLI patterns.
  aws-cli.llm.md   AWS account — profiles, S3, Amplify, CloudFront, Lambda.

## Active Projects

See manifest.json for the full machine-readable list.

On Gitea (local, Tailscale required):
  aarete-doczyai-app   Aarete DocyAI SaaS UI — document intelligence platform
  llm-tools            This repo — LLM access guides and tooling
  mp-banner-and-pyre*  Mathison Projects banner/pyre suite

On GitHub (public):
  MathisonProjects/ocia-aquinas           RCIA Catholic conversion aid
  MathisonProjects/Claravue              Laravel + VueJS starter kit
  MathisonProjects/personal-website      Vue personal site
  MathisonProjects/F5-TTS                AI TTS fork
  silmaai/silmaai                        Silma profile README
  silmaai/albert-webdev-frontend         Amplify SSR deploy

## Environment Notes

  - Tailscale network: devices named Orson, Hagia, Theodora, Tabitha, Ozymandias
  - Gitea runs on Hagia (Seagate 8TB external drive) via Orson (Mac mini)
  - CI/CD: Gitea Actions with act_runner on Orson (host mode, Node.js v24)
  - LAN range: 192.168.12.0/24

## Conventions

  - Default branch: main
  - Commit style: conventional commits (feat:, fix:, ci:, docs:, chore:)
  - Node version: 20.x (LTS) for CI, 24.x on host
  - Package manager: npm

## Contact

  Jacob Mathison
  jacob@mathisonprojects.com
  https://www.mathisonprojectsinc.com