167 lines
5.6 KiB
Markdown
167 lines
5.6 KiB
Markdown
# 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
|