From 6b21f6b1681cb75b23879cdf13f2a09bbf48e91e Mon Sep 17 00:00:00 2001 From: Jacob Mathison Date: Sat, 30 May 2026 23:33:47 -0500 Subject: [PATCH] docs: add github.llm.md, update llm.txt + manifest.json with all 6 files; add .gitignore --- .gitignore | 5 ++ github.llm.md | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++ llm.txt | 18 +++++- manifest.json | 26 +++++++- 4 files changed, 211 insertions(+), 4 deletions(-) create mode 100644 .gitignore create mode 100644 github.llm.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..95d3c76 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +# macOS metadata (ExFAT / third-party drives) +._* +.DS_Store +.Spotlight-V100 +.Trashes diff --git a/github.llm.md b/github.llm.md new file mode 100644 index 0000000..56b3f39 --- /dev/null +++ b/github.llm.md @@ -0,0 +1,166 @@ +# GitHub Access Guide + +This document covers the GitHub accounts and repositories available to AI agents working in Jacob Mathison's stack. + +--- + +## Accounts + +### `MathisonProjects` — Primary GitHub Organization / User +Public profile for Jacob's professional work. Most client-deliverable and open-source projects live here. + +- **GitHub:** https://github.com/MathisonProjects +- **Type:** User account (public repos visible without auth) + +### `silmaai` — Silma AI's GitHub Account +Silma's own GitHub presence. Stores AI-generated projects, backups, private tooling, and project assets. + +- **GitHub:** https://github.com/silmaai +- **Type:** User account + +--- + +## Authentication + +A PAT (Personal Access Token) for `silmaai` is stored in `credentials/secrets.env` as `GITHUB_PAT`. + +```bash +# Load credentials (from workspace root) +source credentials/secrets.env + +# Verify identity +curl -s -H "Authorization: token $GITHUB_PAT" https://api.github.com/user | jq '.login' + +# Clone a private repo +git clone https://$GITHUB_PAT@github.com/silmaai/silma-bone-lord-bob.git +``` + +For HTTPS remotes, embed in URL or use credential helper: +```bash +git remote set-url origin https://@github.com//.git +``` + +--- + +## MathisonProjects Repositories + +### Active / Recent + +| Repo | Visibility | Description | +|------|-----------|-------------| +| `MathisonProjects/ams-agentic-company` | public | AMS agentic company tooling | +| `MathisonProjects/F5-TTS` | public | F5-TTS fork — AI speech synthesis experiments | +| `MathisonProjects/personal-website` | public | Vue personal site (free to review as coding reference) | +| `MathisonProjects/ocia-aquinas` | public | RCIA/Catholic conversion aid (TypeScript) | +| `MathisonProjects/twitter-community-scheduler` | public | Twitter community post scheduler | +| `MathisonProjects/pi-demo-dashboard-matco` | public | Pi demo dashboard | + +### Tools & Infrastructure + +| Repo | Description | +|------|-------------| +| `MathisonProjects/mp-server-dashboard` | PHP server management dashboard | +| `MathisonProjects/mp-bash-scripts` | Server automation bash scripts | +| `MathisonProjects/mp-bash-nav` | Bash scripts for navigation | +| `MathisonProjects/churchmetrics-api-php` | PHP API for Church Metrics | +| `MathisonProjects/OffSiteCredentialsGrabber` | Credentials from outside server (basic auth) | + +### Frameworks & Starters + +| Repo | Description | +|------|-------------| +| `MathisonProjects/Claravue` | Laravel + VueJS starter kit (MIT) | +| `MathisonProjects/laravel-cors` | CORS headers for Laravel | +| `MathisonProjects/zing-node-default` | Node service with real-time connection patterns | +| `MathisonProjects/zing-vuejs-default` | VueJS standard deploy package | +| `MathisonProjects/zing-cdn` | Default CSS/JS CDN files | +| `MathisonProjects/sql-notify-node` | NodeJS SQL change notification server | +| `MathisonProjects/webpire` | Web project starter | + +### Reference & Docs + +| Repo | Description | +|------|-------------| +| `MathisonProjects/howtos` | Code how-to references | +| `MathisonProjects/mp-sublime-snippets` | Sublime Text snippets | + +--- + +## silmaai Repositories + +| Repo | Visibility | Description | +|------|-----------|-------------| +| `silmaai/silmaai` | public | Profile README — who Silma is | +| `silmaai/albert-webdev-frontend` | public | Amplify SSR deploy for albert-webdev.com | +| `silmaai/eloi-web-app` | private | Eloi web app | +| `silmaai/eloi-react-native` | private | Eloi React Native app | +| `silmaai/silma-ai-webapp` | private | Silma AI web app | +| `silmaai/silma-bone-lord-bob` | private | Bone Lord Bob project assets and work | +| `silmaai/silma-usdw` | private | U.S. Data Watch — real numbers on American life | +| `silmaai/silma-kittens` | private | Silma remote node (kittens WebSocket bridge) | +| `silmaai/silma-backups` | private | Silma memory, database, and config backups | + +--- + +## Common GitHub CLI Patterns + +```bash +# List your repos +gh repo list MathisonProjects --limit 50 +gh repo list silmaai --limit 20 + +# Clone a repo +gh repo clone MathisonProjects/ocia-aquinas +gh repo clone silmaai/silma-bone-lord-bob + +# Create a new repo +gh repo create MathisonProjects/new-repo --private --clone + +# View open issues +gh issue list --repo MathisonProjects/ocia-aquinas + +# Create a PR +gh pr create --title "feat: my feature" --body "description" + +# Check Actions runs +gh run list --repo MathisonProjects/ocia-aquinas +gh run view --log +``` + +--- + +## GitHub API Quick Reference + +```bash +source credentials/secrets.env + +BASE="https://api.github.com" +AUTH="-H \"Authorization: token $GITHUB_PAT\"" + +# List repos for an org/user +curl -s $AUTH "$BASE/users/MathisonProjects/repos?per_page=100" | jq '.[].full_name' + +# Get a specific repo +curl -s $AUTH "$BASE/repos/MathisonProjects/ocia-aquinas" + +# List branches +curl -s $AUTH "$BASE/repos/MathisonProjects/ocia-aquinas/branches" | jq '.[].name' + +# Get latest commit on main +curl -s $AUTH "$BASE/repos/MathisonProjects/ocia-aquinas/commits/main" | jq '.sha, .commit.message' + +# Create a file via API (content must be base64) +curl -s $AUTH -X PUT "$BASE/repos///contents/path/to/file.txt" \ + -H "Content-Type: application/json" \ + -d "{\"message\":\"add file\",\"content\":\"$(echo 'Hello' | base64)\"}" +``` + +--- + +## Notes for AI Agents + +- **`silmaai` PAT** is the working token — use `$GITHUB_PAT` from `credentials/secrets.env` +- **`MathisonProjects`** is a public GitHub user, not an org — no org-level API calls needed +- Most active client work lives in **private repos on Gitea** (see `gitea.llm.md`), not GitHub +- GitHub is primarily used for **open-source / public-facing** repos and profile presence +- Don't push private client code or secrets to GitHub — use the local Gitea instance for that diff --git a/llm.txt b/llm.txt index ff559d2..a294c95 100644 --- a/llm.txt +++ b/llm.txt @@ -28,17 +28,29 @@ To authenticate, generate a Personal Access Token at: ## Files in This Repo + 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 Full Gitea access guide with API examples and auth setup. + 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 on Gitea +## Active Projects See manifest.json for the full machine-readable list. -Notable repos: +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 + +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 ## Environment Notes diff --git a/manifest.json b/manifest.json index 977afa4..f5d323d 100644 --- a/manifest.json +++ b/manifest.json @@ -114,9 +114,33 @@ "package_manager": "npm" }, + "github": { + "accounts": [ + { + "login": "MathisonProjects", + "type": "user", + "url": "https://github.com/MathisonProjects", + "visibility": "public", + "notable_repos": ["ocia-aquinas", "Claravue", "personal-website", "F5-TTS", "twitter-community-scheduler", "mp-server-dashboard", "ams-agentic-company"] + }, + { + "login": "silmaai", + "type": "user", + "url": "https://github.com/silmaai", + "visibility": "mixed", + "pat_env_var": "GITHUB_PAT", + "pat_source": "credentials/secrets.env", + "notable_repos": ["silmaai", "albert-webdev-frontend", "silma-bone-lord-bob", "silma-usdw", "silma-kittens", "silma-backups"] + } + ] + }, + "files": { + "README.md": "Human + AI overview, quick-start, environment at a glance", "llm.txt": "Plain-text overview for LLM agents", "manifest.json": "This file — machine-readable index of repos, tools, and endpoints", - "gitea.llm.md": "Full Gitea access guide with API examples and auth setup" + "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 buckets, Amplify apps, CloudFront, Lambda" } }