GitHub Organizationで特定テンプレートから生成されたリポジトリ数をGitHub CLIとjqで調べてみた

gh repo list <ORG>

Showing 30 of <TOTAL> repositories in @<ORG>

NAME                DESCRIPTION          INFO     UPDATED
<ORG>/prj-xxxx                           private  about 1 hour ago
<ORG>/prj-yyyy      サンプルの説明文      private  about 2 hours ago
（以下省略）

gh repo list <ORG> --json name,templateRepository --limit 5

[
  {
    "name": "prj-bar",
    "templateRepository": null
  },
  {
    "name": "prj-foo",
    "templateRepository": {
      "id": "R_xxxxxxxxxxxxxxxxxxxxxx",
      "name": "<TEMPLATE_REPO>",
      "owner": {
        "id": "MDxxxxxxxxxxxxxxxxxx",
        "login": "<TEMPLATE_OWNER>"
      }
    }
  }
]

FLAGS
      --archived            Show only archived repositories
      --fork                Show only forks
  -q, --jq expression       Filter JSON output using a jq expression
      --json fields         Output JSON with the specified fields
  -l, --language string     Filter by primary coding language
  -L, --limit int           Maximum number of repositories to list (default 30)
      --no-archived         Omit archived repositories
      --source              Show only non-forks
  -t, --template string     Format JSON output using a Go template; see "gh help formatting"
      --topic strings       Filter by topic
      --visibility string   Filter by repository visibility: {public|private|internal}

#!/usr/bin/env bash
#
# find-template-repos.sh
#
# GitHub organization 内で、指定したテンプレートリポジトリから作成された
# リポジトリの件数と一覧を表示します。
#
# 必要なもの:
#   - GitHub CLI (gh)  https://cli.github.com/
#   - jq
#   - `gh auth login` 済み、かつ対象 org のリポジトリを読める権限を持つトークン
#
# 使い方:
#   ./find-template-repos.sh -o ORG -t TEMPLATE_OWNER/TEMPLATE_REPO [-l LIMIT]
#
# 例:
#   ./find-template-repos.sh -o my-org -t my-org/service-template
#
set -euo pipefail

LIMIT=1000

usage() {
  cat <<'EOF'
Usage: find-template-repos.sh -o ORG -t TEMPLATE_OWNER/TEMPLATE_REPO [-l LIMIT]

  -o ORG                    GitHub organization のログイン名 (例: my-org)
  -t TEMPLATE_OWNER/REPO    テンプレートリポジトリのフルネーム (例: my-org/template-repo)
  -l LIMIT                  org から取得するリポジトリ数の上限 (デフォルト: 1000)
  -h                        このヘルプを表示

事前準備:
  - GitHub CLI (gh) がインストール済みであること https://cli.github.com/
  - jq がインストール済みであること
  - `gh auth login` で認証済みであり、対象 org のリポジトリを読める権限があること
EOF
  exit 1
}

while getopts "o:t:l:h" opt; do
  case "$opt" in
    o) ORG="$OPTARG" ;;
    t) TEMPLATE="$OPTARG" ;;
    l) LIMIT="$OPTARG" ;;
    h|*) usage ;;
  esac
done

if [[ -z "${ORG:-}" || -z "${TEMPLATE:-}" ]]; then
  usage
fi

if ! command -v gh >/dev/null 2>&1; then
  echo "エラー: GitHub CLI (gh) がインストールされていません。https://cli.github.com/ を参照してください。" >&2
  exit 1
fi

if ! command -v jq >/dev/null 2>&1; then
  echo "エラー: jq がインストールされていません。" >&2
  exit 1
fi

if ! gh auth status >/dev/null 2>&1; then
  echo "エラー: gh が認証されていません。'gh auth login' を実行してください。" >&2
  exit 1
fi

echo "org '${ORG}' のリポジトリ一覧を取得中 (最大 ${LIMIT} 件)..." >&2

REPOS_JSON=$(gh repo list "$ORG" --limit "$LIMIT" \
  --json name,templateRepository,createdAt,isArchived,visibility)

FETCHED=$(echo "$REPOS_JSON" | jq 'length')
if [[ "$FETCHED" -ge "$LIMIT" ]]; then
  echo "警告: 取得件数が --limit (${LIMIT}) に達しています。超過分は取得できていない可能性があります。-l で上限を上げてください" >&2
fi

# 注意: --json templateRepository が返すオブジェクトには id/name/owner{login} しか
# 含まれず、nameWithOwner というキーは存在しない。
# .templateRepository.nameWithOwner のような直接比較は常に null になり、
# 該当リポジトリがあっても一致しないバグになるため、owner.login と name を
# 組み立てて比較する。
MATCHED_JSON=$(echo "$REPOS_JSON" | jq --arg tmpl "$TEMPLATE" '
  [ .[] | select(
      .templateRepository != null
      and (.templateRepository.owner.login + "/" + .templateRepository.name) == $tmpl
    ) ]
  | sort_by(.createdAt)
')

COUNT=$(echo "$MATCHED_JSON" | jq 'length')

echo ""
echo "=========================================="
echo "テンプレート     : ${TEMPLATE}"
echo "対象組織         : ${ORG}"
echo "作成されたリポジトリ数: ${COUNT}"
echo "=========================================="
echo ""

if [[ "$COUNT" -eq 0 ]]; then
  echo "該当するリポジトリは見つかりませんでした。"
  echo "(テンプレート名の表記や、gh のアクセス権限をご確認ください)"
else
  # 対象組織は上のヘッダーで表示済みなので、行ごとには name のみ表示する
  # (URL が要る場合は https://github.com/${ORG}/リポジトリ名 で組み立てられる)
  echo "$MATCHED_JSON" | jq -r '
    .[] |
    "- \(.name)  [\(.visibility)]\(if .isArchived then " (archived)" else "" end)\n    作成日  : \(.createdAt)"
  '
fi

./find-template-repos.sh -o <ORG> -t <TEMPLATE_OWNER>/<TEMPLATE_REPO>

org '<ORG>' のリポジトリ一覧を取得中 (最大 1000 件)...

==========================================
テンプレート     : <TEMPLATE_OWNER>/<TEMPLATE_REPO>
対象組織         : <ORG>
作成されたリポジトリ数: 15
==========================================

- prj-xxxx  [PRIVATE]
    作成日  : 2026-xx-xxTxx:xx:xxZ
（以下14件省略）