# llm-tools

This repository is a navigation phonebook for AI agents (Codex, Claude, Cursor, etc.) working in Jacob Mathison's development environment. It answers the core questions an agent needs to orient itself without asking or guessing.

## What is this repo for?

Developers and AI coding agents who need to:
- Access the local self-hosted Gitea instance or GitHub
- Understand what AWS resources exist and how to use them
- Find per-client and per-project context
- Know the conventions, machines, and services in this environment

## Repository Structure

  AGENTS.md              Operational rules for AI agents working in this repo (read this first)
  README.md              Full overview, structure tree, quick-start, environment at a glance
  llm.txt                This file. Plain-text summary for rapid LLM ingestion.
  manifest.json          Machine-readable index of all files, folders, repos, and services

  tools/                 Access guides for external services and platforms
    README.md
    gitea.llm.md         Local self-hosted Gitea — clone URLs, PAT auth, API examples
    github.llm.md        GitHub (MathisonProjects + silmaai) — repos, PAT, CLI patterns
    aws-cli.llm.md       AWS account — profiles, S3, Amplify, CloudFront, Lambda

  agents/                Per-agent configuration, context, and notes
    README.md
    claude.md            Anthropic Claude (Claude Code / API)
    cursor.md            Cursor IDE AI
    codex.md             OpenAI Codex / ChatGPT with code access

  workflows/             Reusable workflows, automation scripts, and prompt chains
    README.md

  documents/             Project specs, architecture docs, written context
    README.md

  analytics/             Data sources, dashboards, reporting guides
    README.md

  clients/               Per-client context for active engagements
    README.md
    aarete.md            Aarete Group — DocyAI SaaS platform

  projects/              Internal and personal project context
    README.md
    silma-ai.md          Silma AI — OCPlatform, k8s stack, repos
    banner-and-pyre.md   MP Banner and Pyre — 3-repo suite, Amplify deploy

## Local Gitea Instance

Self-hosted Gitea v1.26.2 on the local Tailscale network:

  URL:    http://100.79.253.19:3000
  Owner:  jacob-mathison
  Access: Tailscale VPN required

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

Clone a repo:
  git clone http://100.79.253.19:3000/jacob-mathison/<repo-name>.git

Generate a PAT at:
  http://100.79.253.19:3000/user/settings/applications

Active Gitea repos:
  aarete-doczyai-app           Aarete DocyAI SaaS UI (private)
  mp-banner-and-pyre           Mathison Projects Banner and Pyre (private)
  mp-banner-and-pyre-migration Migration layer (private)
  mp-banner-and-pyre-web       Web frontend (private)
  llm-tools                    This repo (public)

## GitHub

  MathisonProjects:  https://github.com/MathisonProjects  (public work, OSS)
  silmaai:           https://github.com/silmaai           (Silma AI projects, mixed)
  PAT:               $GITHUB_PAT in credentials/secrets.env

Notable GitHub repos:
  MathisonProjects/ocia-aquinas            RCIA Catholic conversion aid (TypeScript)
  MathisonProjects/Claravue               Laravel + VueJS starter kit
  MathisonProjects/F5-TTS                  AI TTS fork
  MathisonProjects/ams-agentic-company     AMS agentic tooling
  silmaai/silma-bone-lord-bob              Bone Lord Bob assets (private)
  silmaai/silma-usdw                       U.S. Data Watch (private)
  silmaai/silma-kittens                    Remote node bridge (private)

## AWS

  Account ID:     567637986724
  IAM User:       jacob_mathison
  IAM Groups:     Administrator-Access (full access)
  Default Region: us-east-1
  Profiles:       default, mp-mac-tabitha

Verify access:
  aws sts get-caller-identity

Key resources:
  Amplify apps:   16 active apps (see tools/aws-cli.llm.md for full list)
  S3 buckets:     100+ buckets (Amplify deployments, media, static sites)
  CloudFront:     16 distributions
  Lambda:         Multiple functions in us-east-1

## Environment

  Primary dev machine:  Tabitha (MacBook Pro arm64, 100.76.192.116)
  Gitea host:           Orson / Hagia (100.79.253.19)
  Travel / coding box:  Ozymandias (100.115.222.5)
  Tailscale network:    All machines reachable by Tailscale IP
  LAN range:            192.168.12.0/24
  CI runner:            orson-runner (act_runner v0.6.1, host mode, Node 24)

## Conventions

  Default branch:  main
  Commit style:    Conventional Commits (feat:, fix:, ci:, docs:, chore:)
  Node (CI):       20.x LTS
  Package manager: npm
  IaC:             AWS Amplify Gen 2 for frontend projects

## Contact

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