docs: sync llm.txt with current repo structure (tools/, clients/, projects/)
This commit is contained in:
@@ -1,70 +1,124 @@
|
|||||||
# llm-tools
|
# 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?
|
## What is this repo for?
|
||||||
|
|
||||||
Developers and AI coding agents who need to:
|
Developers and AI coding agents who need to:
|
||||||
- Access the local self-hosted Gitea instance
|
- Access the local self-hosted Gitea instance or GitHub
|
||||||
- Understand the project layout and available repositories
|
- Understand what AWS resources exist and how to use them
|
||||||
- Bootstrap themselves into the local dev environment
|
- 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
|
## 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
|
URL: http://100.79.253.19:3000
|
||||||
Owner: jacob-mathison
|
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
|
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
|
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
|
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.
|
## GitHub
|
||||||
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
|
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):
|
## AWS
|
||||||
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):
|
Account ID: 567637986724
|
||||||
MathisonProjects/ocia-aquinas RCIA Catholic conversion aid
|
IAM User: jacob_mathison
|
||||||
MathisonProjects/Claravue Laravel + VueJS starter kit
|
IAM Groups: Administrator-Access (full access)
|
||||||
MathisonProjects/personal-website Vue personal site
|
Default Region: us-east-1
|
||||||
MathisonProjects/F5-TTS AI TTS fork
|
Profiles: default, mp-mac-tabitha
|
||||||
silmaai/silmaai Silma profile README
|
|
||||||
silmaai/albert-webdev-frontend Amplify SSR deploy
|
|
||||||
|
|
||||||
## Environment Notes
|
Verify access:
|
||||||
|
aws sts get-caller-identity
|
||||||
|
|
||||||
- Tailscale network: devices named Orson, Hagia, Theodora, Tabitha, Ozymandias
|
Key resources:
|
||||||
- Gitea runs on Hagia (Seagate 8TB external drive) via Orson (Mac mini)
|
Amplify apps: 16 active apps (see tools/aws-cli.llm.md for full list)
|
||||||
- CI/CD: Gitea Actions with act_runner on Orson (host mode, Node.js v24)
|
S3 buckets: 100+ buckets (Amplify deployments, media, static sites)
|
||||||
- LAN range: 192.168.12.0/24
|
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
|
## Conventions
|
||||||
|
|
||||||
- Default branch: main
|
Default branch: main
|
||||||
- Commit style: conventional commits (feat:, fix:, ci:, docs:, chore:)
|
Commit style: Conventional Commits (feat:, fix:, ci:, docs:, chore:)
|
||||||
- Node version: 20.x (LTS) for CI, 24.x on host
|
Node (CI): 20.x LTS
|
||||||
- Package manager: npm
|
Package manager: npm
|
||||||
|
IaC: AWS Amplify Gen 2 for frontend projects
|
||||||
|
|
||||||
## Contact
|
## Contact
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user