Meshtastic Org Knowledge

Meshtastic org knowledge

Answer org-wide questions using the gh CLI via bash. No GitHub MCP server needed — gh is already authenticated, uses near-zero tokens (no schema overhead), and is more reliable than the MCP server for read-only org queries.

Prerequisite: gh auth status must show github.com logged in. If not:

gh auth login   # or: gh auth login --with-token <<< "$GITHUB_TOKEN"

Recipes

Discover repos

# All active repos in the org (sorted by recent push)
gh repo list meshtastic --limit 100 --json name,description,pushedAt,defaultBranchRef \
  --jq 'sort_by(.pushedAt) | reverse | .[] | [.name, .pushedAt, .description] | @tsv'

# Search for repos matching a topic or name
gh repo list meshtastic --limit 100 --json name,description \
  --jq '.[] | select(.name | test("android|apple|firmware|python"; "i"))'

Read docs

# README for a repo
gh repo view meshtastic/<repo> --json description,readme --jq '.readme'

# Arbitrary file
gh api repos/meshtastic/<repo>/contents/README.md --jq '.content' | base64 -d

# AGENTS.md / CLAUDE.md
gh api repos/meshtastic/<repo>/contents/AGENTS.md --jq '.content' | base64 -d

# Search code across the org
gh search code "<symbol-or-phrase>" --owner meshtastic --limit 20 \
  --json path,repository --jq '.[] | [.repository.name, .path] | @tsv'

Repo status

# Latest release
gh release view --repo meshtastic/<repo> --json tagName,publishedAt,body

# All releases
gh release list --repo meshtastic/<repo> --limit 10

# Open PRs
gh pr list --repo meshtastic/<repo> --state open --json number,title,updatedAt,author \
  --jq 'sort_by(.updatedAt) | reverse | .[0:10]'

# Open issues
gh issue list --repo meshtastic/<repo> --state open --limit 20 \
  --json number,title,updatedAt,labels \
  --jq 'sort_by(.updatedAt) | reverse | .[]'

# Recent commits
gh api repos/meshtastic/<repo>/commits --jq '.[0:10] | .[] | [.sha[0:8], .commit.message | split("\n")[0]] | @tsv'

Org-wide recent activity

# Recent commits across org (last N days)
gh search commits --owner meshtastic --sort committer-date --order desc --limit 30 \
  --json repository,sha,commit --jq '.[] | [.repository.name, .sha[0:8], .commit.message | split("\n")[0]] | @tsv'

# Recently merged PRs (closedAt = merge date for merged PRs)
gh search prs --owner meshtastic --merged --sort updated --order desc --limit 20 \
  --json repository,number,title,closedAt \
  --jq '.[] | [.closedAt[0:10], .repository.name, (.number|tostring), .title] | @tsv'

# Recently opened issues
gh search issues --owner meshtastic --state open --sort updated --order desc --limit 20 \
  --json repository,number,title,updatedAt \
  --jq '.[] | [.repository.name, (.number|tostring), .title] | @tsv'

Cross-repo map

Default branches vary — pass --ref <branch> or gh api ... ?ref=<branch> when reading off a non-default branch.

Tips

• Pipe to jq for structured filtering; --jq inline keeps it one command.
• gh api gives raw REST access for anything gh sub-commands don't expose:

  gh api orgs/meshtastic/repos --paginate --jq '.[].name'
  

• Add --limit 100 to list commands — default is 30.
• gh search code scans the default branch only; use gh api search/code?q=... for cross-branch searches.