nodmix 2026.5.25

package/skills/eightctl/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: eightctl
+description: "Control Eight Sleep pods (status, temperature, alarms, schedules)."
+homepage: https://eightctl.sh
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "🛌",
+        "requires": { "bins": ["eightctl"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/eightctl/cmd/eightctl@latest",
+              "bins": ["eightctl"],
+              "label": "Install eightctl (go)",
+            },
+          ],
+      },
+  }
+---
+
+# eightctl
+
+Use `eightctl` for Eight Sleep pod control. Requires auth.
+
+Auth
+
+- Config: `~/.config/eightctl/config.yaml`
+- Env: `EIGHTCTL_EMAIL`, `EIGHTCTL_PASSWORD`
+
+Quick start
+
+- `eightctl status`
+- `eightctl on|off`
+- `eightctl temp 20`
+
+Common tasks
+
+- Alarms: `eightctl alarm list|create|dismiss`
+- Schedules: `eightctl schedule list|create|update`
+- Audio: `eightctl audio state|play|pause`
+- Base: `eightctl base info|angle`
+
+Notes
+
+- API is unofficial and rate-limited; avoid repeated logins.
+- Confirm before changing temperature or alarms.

package/skills/gemini/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: gemini
+description: "Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing."
+homepage: https://ai.google.dev/
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "✨",
+        "requires": { "bins": ["gemini"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "gemini-cli",
+              "bins": ["gemini"],
+              "label": "Install Gemini CLI (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Gemini CLI
+
+Use Gemini in headless one-shot mode. Positional text starts interactive mode; use `-p/--prompt`.
+
+Quick start
+
+- `gemini -p "Answer this question..."`
+- `gemini -m <model> -p "Prompt..."`
+- `gemini -p "Return JSON" --output-format json`
+- stdin appends to `-p`: `cat notes.md | gemini -p "Summarize"`
+
+Extensions
+
+- List: `gemini --list-extensions`
+- Manage: `gemini extensions <command>`
+- Skills: `gemini skills <command>`
+- Hooks: `gemini hooks <command>`
+- MCP: `gemini mcp <command>`
+
+Notes
+
+- If auth is required, run `gemini` once interactively and follow the login flow.
+- Avoid `--yolo` for safety.

package/skills/gh-issues/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: gh-issues
+description: "Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments."
+user-invocable: true
+metadata:
+  {
+    "nodmix":
+      {
+        "requires": { "bins": ["git", "gh"] },
+        "primaryEnv": "GH_TOKEN",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "gh",
+              "bins": ["gh"],
+              "label": "Install GitHub CLI (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# gh-issues
+
+Use for issue-to-PR automation. Prefer `gh` CLI; fall back to `gh api` only when a high-level command lacks the needed field.
+
+## Arguments
+
+- positional `owner/repo`: optional; else infer from `git remote get-url origin`.
+- `--label <label>`: filter.
+- `--limit <n>`: default 10.
+- `--milestone <title>`: filter.
+- `--assignee <login|@me>`: filter.
+- `--state open|closed|all`: default open.
+- `--fork <owner/repo>`: push branches to fork, PR to source.
+- `--watch`: poll issues + reviews.
+- `--interval <minutes>`: default 5.
+- `--dry-run`: list only.
+- `--yes`: no confirmation.
+- `--reviews-only`: skip issue fixing; handle PR reviews.
+- `--cron`: spawn and exit; implies `--yes`.
+- `--model <id>`: pass to workers when supported.
+- `--notify-channel <id>`: optional final notification target.
+
+## Phase 1: resolve repo
+
+```bash
+git remote get-url origin
+if [ -z "${GH_TOKEN:-}" ]; then
+  CONFIG_PATH="${NODMIX_CONFIG_PATH:-${NODMIX_STATE_DIR:-$HOME/.nodmix}/nodmix.json}"
+  GH_TOKEN=$(jq -r '.skills.entries["gh-issues"].apiKey // empty' "$CONFIG_PATH" 2>/dev/null || true)
+  if [ -n "$GH_TOKEN" ]; then export GH_TOKEN; fi
+fi
+gh auth status
+gh repo view OWNER/REPO --json nameWithOwner,defaultBranchRef
+```
+
+If `gh auth status` fails and `GH_TOKEN` is missing, stop and ask for GitHub auth/config.
+
+Derived:
+
+- `SOURCE_REPO`: issue repo.
+- `PUSH_REPO`: fork if set, else source.
+- `BASE_BRANCH`: source default branch unless user says otherwise.
+- `PUSH_REMOTE`: `fork` in fork mode, else `origin`.
+
+Stop on dirty worktree unless user confirms that workers should ignore uncommitted changes.
+
+In fork mode, do not mutate remotes before confirmation or during `--dry-run`.
+
+Verify auth/read access only:
+
+```bash
+gh auth token >/dev/null || test -n "${GH_TOKEN:-}"
+gh repo view "$PUSH_REPO" --json nameWithOwner
+git ls-remote --exit-code origin HEAD
+```
+
+## Phase 2: fetch issues
+
+Build filters and fetch:
+
+```bash
+gh issue list --repo "$SOURCE_REPO" --state open --limit 10 --json number,title,labels,url,body,assignees,milestone
+```
+
+Add `--label`, `--milestone`, `--assignee`, `--state`, `--limit` as requested. `gh issue list` already excludes PRs.
+
+If none found: report no matches. If `--dry-run`: show compact list and stop.
+
+## Phase 3: avoid duplicate work
+
+For each candidate:
+
+```bash
+gh pr list --repo "$SOURCE_REPO" --search "$SOURCE_REPO#<n>" --state open --json number,url,title,headRefName
+gh pr list --repo "$SOURCE_REPO" --head "fix/issue-<n>" --state open --json number,url
+gh api "repos/$PUSH_REPO/branches/fix/issue-<n>" >/dev/null
+```
+
+Skip candidates with an open PR, existing branch, or active local claim.
+
+Claim file:
+
+```text
+${NODMIX_STATE_DIR:-$HOME/.nodmix}/gh-issues-<owner>-<repo>.json
+```
+
+Expire claims older than 2 hours.
+Create the parent directory before writing.
+
+## Phase 4: confirm
+
+Unless `--yes` or `--cron`, ask user to choose:
+
+- `all`
+- comma-separated issue numbers
+- `cancel`
+
+After confirmation, in fork mode, configure the push remote before handing work to agents:
+
+```bash
+gh auth setup-git
+git remote get-url fork || git remote add fork "https://github.com/$PUSH_REPO.git"
+git remote set-url fork "https://github.com/$PUSH_REPO.git"
+git ls-remote --exit-code fork HEAD
+```
+
+## Phase 5: spawn workers
+
+Launch up to 8 background workers. Do not block on each worker when `--cron`.
+
+Before each spawn, write a claim for `SOURCE_REPO#<n>` with the current ISO timestamp. After a worker reports PR/failure, remove or update the claim. This prevents watch/cron overlap before a branch or PR exists.
+
+Worker prompt must include:
+
+- issue URL, title, body, labels.
+- `SOURCE_REPO`, `PUSH_REPO`, `BASE_BRANCH`, `PUSH_REMOTE`, fork mode.
+- target branch `fix/issue-<n>`.
+- required proof and PR body.
+- notification route.
+
+Worker instructions:
+
+```text
+Use gh and git. Do not handwave.
+Checkout/create fix/issue-<n> from BASE_BRANCH.
+Implement minimal fix.
+Run relevant tests.
+Commit with conventional message.
+Push to PUSH_REMOTE.
+Open PR against SOURCE_REPO BASE_BRANCH.
+PR body: Summary + Verification + Fixes SOURCE_REPO#<n>.
+Report PR URL or failure reason.
+Send completion/failure with nodmix message send if route provided.
+```
+
+Use `coding-agent` launch rules when available.
+
+## Phase 6: collect
+
+Poll workers with `process` or task registry. Report:
+
+- issue number + title.
+- status: PR opened, skipped, failed, timed out.
+- PR URL or reason.
+
+Notify channel only with final compact summary.
+
+## Reviews-only / watch reviews
+
+Discover open PRs:
+
+```bash
+gh pr list --repo "$SOURCE_REPO" --state open --json number,title,url,headRefName,reviewDecision \
+  --jq '[.[] | select(.headRefName | startswith("fix/issue-"))]'
+```
+
+Fetch review threads/comments:
+
+```bash
+gh pr view <n> --repo "$SOURCE_REPO" --json url,headRefName,comments,reviews
+gh api "repos/$SOURCE_REPO/pulls/<n>/comments"
+gh api "repos/$SOURCE_REPO/issues/<n>/comments"
+```
+
+Only process `fix/issue-*` PRs created by this workflow unless the user explicitly named PR numbers. Group actionable comments by PR. Ignore praise, status, duplicates, and already-addressed comments. Spawn one worker per selected/scoped PR, same background rules.
+
+Review worker instructions:
+
+```text
+Checkout PR branch.
+Read all actionable review comments.
+Patch minimal changes.
+Run relevant tests.
+Commit and push normally; do not force-push unless explicitly told.
+Reply to addressed comments with fix + commit/file reference.
+Report comments addressed/skipped and proof.
+```
+
+## Watch mode
+
+Loop:
+
+1. Fetch issues.
+2. Spawn eligible issue workers.
+3. Process actionable PR reviews.
+4. Sleep `--interval`.
+5. Stop when user says stop.
+
+Keep cumulative summary small.

package/skills/gifgrep/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: gifgrep
+description: "Search GIF providers with CLI/TUI, download results, and extract stills/sheets."
+homepage: https://gifgrep.com
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "🧲",
+        "requires": { "bins": ["gifgrep"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/gifgrep",
+              "bins": ["gifgrep"],
+              "label": "Install gifgrep (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/gifgrep/cmd/gifgrep@latest",
+              "bins": ["gifgrep"],
+              "label": "Install gifgrep (go)",
+            },
+          ],
+      },
+  }
+---
+
+# gifgrep
+
+Use `gifgrep` to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
+
+GIF-Grab (gifgrep workflow)
+
+- Search -> preview -> download -> extract (still/sheet) for fast review and sharing.
+
+Quick start
+
+- `gifgrep cats --max 5`
+- `gifgrep cats --format url | head -n 5`
+- `gifgrep search --json cats | jq '.[0].url'`
+- `gifgrep tui "office handshake"`
+- `gifgrep cats --download --max 1 --format url`
+
+TUI + previews
+
+- TUI: `gifgrep tui "query"`
+- CLI still previews: `--thumbs` (Kitty/Ghostty only; still frame)
+
+Download + reveal
+
+- `--download` saves to `~/Downloads`
+- `--reveal` shows the last download in Finder
+
+Stills + sheets
+
+- `gifgrep still ./clip.gif --at 1.5s -o still.png`
+- `gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png`
+- Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
+- Tune: `--frames` (count), `--cols` (grid width), `--padding` (spacing).
+
+Providers
+
+- `--source auto|tenor|giphy`
+- `GIPHY_API_KEY` required for `--source giphy`
+- `TENOR_API_KEY` optional (Tenor demo key used if unset)
+
+Output
+
+- `--json` prints an array of results (`id`, `title`, `url`, `preview_url`, `tags`, `width`, `height`)
+- `--format` for pipe-friendly fields (e.g., `url`)
+
+GIF asset hygiene
+
+- Before recommending or using an animated GIF URL, verify it resolves successfully, has `Content-Type: image/gif`, and is actually animated (multiple frames or loop metadata; e.g. inspect with `file`, `identify`, or a small script).
+- Record attribution/license/source URL alongside the asset.
+- Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file.
+
+Environment tweaks
+
+- `GIFGREP_SOFTWARE_ANIM=1` to force software animation
+- `GIFGREP_CELL_ASPECT=0.5` to tweak preview geometry

package/skills/github/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: github
+description: "GitHub CLI for issues, PRs, CI/check logs, comments, reviews, releases, repos, and gh api queries."
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "🐙",
+        "requires": { "bins": ["gh"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "gh",
+              "bins": ["gh"],
+              "label": "Install GitHub CLI (brew)",
+            },
+            {
+              "id": "apt",
+              "kind": "apt",
+              "package": "gh",
+              "bins": ["gh"],
+              "label": "Install GitHub CLI (apt)",
+            },
+          ],
+      },
+  }
+---
+
+# GitHub
+
+Use `gh` for GitHub. Use `git` for local commits/branches/push/pull. Use code-reading tools for deep reviews.
+
+## Auth
+
+```bash
+gh auth status
+gh auth login
+```
+
+Gateway HOME can differ from operator HOME. If `gh` auth exists elsewhere, set `GH_CONFIG_DIR` in the gateway service env and restart.
+
+## PRs
+
+```bash
+gh pr list --repo owner/repo --json number,title,state,author,url
+gh pr view 55 --repo owner/repo --json title,body,author,files,commits,reviews,reviewDecision
+gh pr checks 55 --repo owner/repo
+gh pr diff 55 --repo owner/repo
+gh pr create --repo owner/repo --title "feat: title" --body-file /tmp/pr.md
+gh pr merge 55 --repo owner/repo --squash
+```
+
+URLs work directly: `gh pr view https://github.com/owner/repo/pull/55`.
+
+## Issues
+
+```bash
+gh issue list --repo owner/repo --state open --json number,title,labels,url
+gh issue view 42 --repo owner/repo --json title,body,comments,labels,state
+gh issue create --repo owner/repo --title "Bug: ..." --body-file /tmp/issue.md
+gh issue comment 42 --repo owner/repo --body-file /tmp/comment.md
+gh issue close 42 --repo owner/repo --comment "Fixed in ..."
+```
+
+## CI/runs
+
+```bash
+gh run list --repo owner/repo --limit 10
+gh run view <run-id> --repo owner/repo --json status,conclusion,headSha,url
+gh run view <run-id> --repo owner/repo --log-failed
+gh run rerun <run-id> --repo owner/repo --failed
+```
+
+## API
+
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+gh api repos/owner/repo/labels --jq '.[].name'
+gh api --cache 1h repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'
+```
+
+Use `--json` + `--jq` for structured output. Use `--body-file` for comments/bodies containing backticks, shell snippets, env names, or user text.

package/skills/gog/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: gog
+description: "Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs."
+homepage: https://gogcli.sh
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "🎮",
+        "requires": { "bins": ["gog"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/gogcli",
+              "bins": ["gog"],
+              "label": "Install gog (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# gog
+
+Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
+
+Setup (once)
+
+- `gog auth credentials /path/to/client_secret.json`
+- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets`
+- `gog auth list`
+
+Common commands
+
+- Gmail search: `gog gmail search 'newer_than:7d' --max 10`
+- Gmail messages search (per email, ignores threading): `gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com`
+- Gmail send (plain): `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`
+- Gmail send (multi-line): `gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt`
+- Gmail send (stdin): `gog gmail send --to a@b.com --subject "Hi" --body-file -`
+- Gmail send (HTML): `gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"`
+- Gmail draft: `gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt`
+- Gmail send draft: `gog gmail drafts send <draftId>`
+- Gmail reply: `gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>`
+- Calendar list events: `gog calendar events <calendarId> --from <iso> --to <iso>`
+- Calendar create event: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>`
+- Calendar create with color: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7`
+- Calendar update event: `gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4`
+- Calendar show colors: `gog calendar colors`
+- Drive search: `gog drive search "query" --max 10`
+- Contacts: `gog contacts list --max 20`
+- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`
+- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
+- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
+- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`
+- Sheets metadata: `gog sheets metadata <sheetId> --json`
+- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`
+- Docs cat: `gog docs cat <docId>`
+
+Calendar Colors
+
+- Use `gog calendar colors` to see all available event colors (IDs 1-11)
+- Add colors to events with `--event-color <id>` flag
+- Event color IDs (from `gog calendar colors` output):
+  - 1: #a4bdfc
+  - 2: #7ae7bf
+  - 3: #dbadff
+  - 4: #ff887c
+  - 5: #fbd75b
+  - 6: #ffb878
+  - 7: #46d6db
+  - 8: #e1e1e1
+  - 9: #5484ed
+  - 10: #51b749
+  - 11: #dc2127
+
+Email Formatting
+
+- Prefer plain text. Use `--body-file` for multi-paragraph messages (or `--body-file -` for stdin).
+- Same `--body-file` pattern works for drafts and replies.
+- `--body` does not unescape `\n`. If you need inline newlines, use a heredoc or `$'Line 1\n\nLine 2'`.
+- Use `--body-html` only when you need rich formatting.
+- HTML tags: `<p>` for paragraphs, `<br>` for line breaks, `<strong>` for bold, `<em>` for italic, `<a href="url">` for links, `<ul>`/`<li>` for lists.
+- Example (plain text via stdin):
+
+  ```bash
+  gog gmail send --to recipient@example.com \
+    --subject "Meeting Follow-up" \
+    --body-file - <<'EOF'
+  Hi Name,
+
+  Thanks for meeting today. Next steps:
+  - Item one
+  - Item two
+
+  Best regards,
+  Your Name
+  EOF
+  ```
+
+- Example (HTML list):
+  ```bash
+  gog gmail send --to recipient@example.com \
+    --subject "Meeting Follow-up" \
+    --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"
+  ```
+
+Notes
+
+- Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`.
+- For scripting, prefer `--json` plus `--no-input`.
+- Sheets values can be passed via `--values-json` (recommended) or as inline rows.
+- Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
+- Confirm before sending mail or creating events.
+- `gog gmail search` returns one row per thread; use `gog gmail messages search` when you need every individual email returned separately.

package/skills/goplaces/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: goplaces
+description: "Query Google Places for text search, place details, resolve, reviews, or scriptable JSON via goplaces."
+homepage: https://github.com/steipete/goplaces
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "📍",
+        "requires": { "bins": ["goplaces"], "env": ["GOOGLE_PLACES_API_KEY"] },
+        "primaryEnv": "GOOGLE_PLACES_API_KEY",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/goplaces",
+              "bins": ["goplaces"],
+              "label": "Install goplaces (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# goplaces
+
+Modern Google Places API (New) CLI. Human output by default, `--json` for scripts.
+
+Install
+
+- Homebrew: `brew install steipete/tap/goplaces`
+
+Config
+
+- `GOOGLE_PLACES_API_KEY` required.
+- Optional: `GOOGLE_PLACES_BASE_URL` for testing/proxying.
+
+Common commands
+
+- Search: `goplaces search "coffee" --open-now --min-rating 4 --limit 5`
+- Bias: `goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000`
+- Pagination: `goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"`
+- Resolve: `goplaces resolve "Soho, London" --limit 5`
+- Details: `goplaces details <place_id> --reviews`
+- JSON: `goplaces search "sushi" --json`
+
+Notes
+
+- `--no-color` or `NO_COLOR` disables ANSI color.
+- Price levels: 0..4 (free -> very expensive).
+- Type filter sends only the first `--type` value (API accepts one).