docs: add github.llm.md, update llm.txt + manifest.json with all 6 files; add .gitignore
This commit is contained in:
@@ -0,0 +1,5 @@
|
||||
# macOS metadata (ExFAT / third-party drives)
|
||||
._*
|
||||
.DS_Store
|
||||
.Spotlight-V100
|
||||
.Trashes
|
||||
+166
@@ -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://<PAT>@github.com/<owner>/<repo>.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 <run-id> --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/<owner>/<repo>/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
|
||||
@@ -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
|
||||
|
||||
|
||||
+25
-1
@@ -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"
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user