docs: sync llm.txt with current repo structure (tools/, clients/, projects/)
This commit is contained in:
@@ -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/<repo-name>.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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user