128 lines
4.7 KiB
Plaintext
128 lines
4.7 KiB
Plaintext
# 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
|