From e5379b1b6103db1b773fff849f8d9c27b7542b23 Mon Sep 17 00:00:00 2001 From: Jacob Mathison Date: Sat, 30 May 2026 23:50:16 -0500 Subject: [PATCH] docs: sync llm.txt with current repo structure (tools/, clients/, projects/) --- llm.txt | 130 +++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 92 insertions(+), 38 deletions(-) diff --git a/llm.txt b/llm.txt index a294c95..514e55e 100644 --- a/llm.txt +++ b/llm.txt @@ -1,70 +1,124 @@ # llm-tools -This repository contains tooling, guides, and configuration resources for LLM agents (Codex, Claude, Cursor, etc.) working in Jacob Mathison's development environment. +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 -- Understand the project layout and available repositories -- Bootstrap themselves into the local dev environment +- 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 -A self-hosted Gitea (v1.26.2) runs on the local Tailscale network: +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 (ask Jacob for an invite) + Access: Tailscale VPN required -To verify connectivity: +Verify connectivity: curl -s http://100.79.253.19:3000/api/v1/version -To clone any repo: +Clone a repo: git clone http://100.79.253.19:3000/jacob-mathison/.git -To authenticate, generate a Personal Access Token at: +Generate a PAT at: http://100.79.253.19:3000/user/settings/applications -## Files in This Repo +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) - 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. +## GitHub -## Active Projects + MathisonProjects: https://github.com/MathisonProjects (public work, OSS) + silmaai: https://github.com/silmaai (Silma AI projects, mixed) + PAT: $GITHUB_PAT in credentials/secrets.env -See manifest.json for the full machine-readable list. +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) -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 +## AWS -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 + Account ID: 567637986724 + IAM User: jacob_mathison + IAM Groups: Administrator-Access (full access) + Default Region: us-east-1 + Profiles: default, mp-mac-tabitha -## Environment Notes +Verify access: + aws sts get-caller-identity - - 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 +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 version: 20.x (LTS) for CI, 24.x on host - - Package manager: npm + 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