llm-tools/github.llm.md

# 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