add 000-configs/, dashboard, templates, .obsidian/, bin/, model-identity

2026-07-29 13:29:47 +00:00
parent c22bd80fe1
commit 36eca4ca89
31 changed files with 1127 additions and 17 deletions
@@ -0,0 +1,202 @@
+# GitHub CLI (gh) Instructions for Open WebUI Models
+
+`gh` is the GitHub CLI — v2.96.0, fully installed and authenticated as **`stateofshit`**.
+
+This document covers how any model on this server can use `gh` for repo management, issues, PRs, and everything GitHub-related.
+
+---
+
+## Quick Reference
+
+```bash
+gh --help              # full help
+gh auth status         # confirm you're logged in
+gh repo list           # list all repos
+gh repo view <repo>    # view a repo
+gh issue list          # list issues in current dir's repo
+gh pr create           # create a pull request
+```
+
+---
+
+## Authentication Status
+
+Already logged in as **`stateofshit`** with token scopes: `admin:public_key`, `gist`, `read:org`, `repo`.
+
+To check:
+
+```bash
+gh auth status
+```
+
+Expected output:
+```
+✓ Logged in to github.com account stateofshit
+✓ Git operations protocol: ssh
+✓ Token scopes: 'admin:public_key', 'gist', 'read:org', 'repo'
+```
+
+---
+
+## Repo Management
+
+### Create a new repo
+
+```bash
+gh repo create <owner>/<name> --private --description "what it is"
+```
+
+Flags:
+- `--private` or `--public`
+- `--clone` — also clone it locally after creating
+- `--push` — push local branch to remote
+
+### List repos
+
+```bash
+gh repo list stateofshit --limit 50
+```
+
+### View a repo
+
+```bash
+gh repo view stateofshit/shit_in_a_vault
+```
+
+### Delete a repo
+
+⚠️ **Irreversible.**
+
+```bash
+gh repo delete stateofshit/shit_in_a_vault --yes
+```
+
+---
+
+## Working With the Vault Repo
+
+The vault lives at `/home/user/02-repos/shit_in_a_vault/`.
+
+Before working with it, read the boot prompt:
+
+```bash
+cat /home/user/02-repos/shit_in_a_vault/04-models/model-boot.md
+```
+
+### Everyday flow
+
+```bash
+cd /home/user/02-repos/shit_in_a_vault
+
+# Check status
+git status
+
+# Stage and commit
+git add -A
+git commit -m "description of changes"
+
+# Push
+git push
+```
+
+No need to authenticate — `git` uses SSH which is already set up via `~/.ssh/config`.
+
+### Pull latest
+
+```bash
+cd /home/user/02-repos/shit_in_a_vault
+git pull
+```
+
+---
+
+## Issues
+
+### Create an issue
+
+```bash
+gh issue create --title "Bug: thing broken" --body "Details here"
+```
+
+### List issues
+
+```bash
+gh issue list
+```
+
+### View / close
+
+```bash
+gh issue view <number>
+gh issue close <number>
+```
+
+---
+
+## Pull Requests
+
+### Create a PR
+
+```bash
+# From a feature branch
+git checkout -b my-feature
+# ... make changes, commit, push ...
+gh pr create --title "Add feature" --body "What it does"
+```
+
+### List / view / merge
+
+```bash
+gh pr list
+gh pr view <number>
+gh pr merge <number>
+```
+
+---
+
+## Gists
+
+```bash
+# Create
+gh gist create file.txt
+
+# List
+gh gist list
+
+# View
+gh gist view <gist-id>
+```
+
+---
+
+## Working With Other Repos
+
+Models can work with any repo `stateofshit` has access to.
+
+### Clone any accessible repo
+
+```bash
+gh repo clone stateofshit/webby /home/user/02-repos/webby
+```
+
+Already cloned repos are in `/home/user/02-repos/`:
+- `webby` — `stateofshit/webby`
+- `shit_in_a_vault` — `stateofshit/shit_in_a_vault`
+
+---
+
+## Environment
+
+- `gh` binary: `/usr/bin/gh` (system-installed)
+- Config: `~/.config/gh/hosts.yml`
+- Token is stored in that config — **do not expose it in chat or in files**
+- Git protocol: SSH (key at `~/.ssh/github_openwebui`)
+
+---
+
+## Notes
+
+- **Never** paste the token or `~/.config/gh/hosts.yml` contents into chat output.
+- **Never** run `gh auth logout` — it will break all future model access.
+- Deleting a repo is permanent. Use `--yes` with extreme care.
+- `gh` respects the current directory's git remote. Run it inside a repo to act on that repo.