# 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

  llm.txt          This file. Plain-text overview for LLM agents.
  manifest.json    Machine-readable index of repos, tools, and endpoints.
  gitea.llm.md     Full Gitea access guide with API examples and auth setup.

## Active Projects on Gitea

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

Notable repos:
  aarete-doczyai-app   Aarete DocyAI SaaS UI — document intelligence platform
  llm-tools            This repo — LLM access guides and tooling

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