From cmux-team
Reads GitHub issues/PRs from current project via local SQLite cache using cmux-team commands, avoiding API rate limits on list/view/search operations. Supports GitHub Enterprise.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cmux-team:cmux-team-ghThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
このスキルは `cmux-team` plugin に同梱される GitHub issue/PR キャッシュの
このスキルは cmux-team plugin に同梱される GitHub issue/PR キャッシュの
使い方リファレンスです。gh issue / gh pr の 読み取り系 は
cmux-team issue / cmux-team pr に置き換えてください。
gh を直接使わないかgh を叩くたびに GitHub API を呼ぶため、複数 issue を走査する用途
(レビュー待ち一覧、最近 close された PR の確認等)で rate limit を
消費しやすい。cmux-team gh sync は ETag (If-None-Match) + since= による差分同期で、
変更がなければ 304 Not Modified(rate limit 消費 0)で返る。以下のいずれかの場合にこのスキルを適用してください:
#272, issue 272, PR #42, T042 等)gh issue list / gh pr view 等を実行したがっているghe ...(企業 GitHub)を実行したがっている — 同じキャッシュで読める@me に割り当てられた issue を探しているbug, help wanted 等)の絞り込みをしたい| 代わりに | 使うもの |
|---|---|
gh issue list --state open --limit 20 | cmux-team issue list --state open --limit 20 |
gh issue list --assignee @me | cmux-team issue list --assignee @me |
gh issue list --label bug | cmux-team issue list --label bug |
gh issue view 272 | cmux-team issue show 272 |
gh issue view 272 --json title,body,labels | cmux-team issue show 272 --json title,body,labels |
gh pr list --state open | cmux-team pr list --state open |
gh pr view 42 | cmux-team pr show 42 |
gh pr view 42 --json state,title,reviews | cmux-team pr show 42 --json state,title,reviews |
gh search issues keyword | cmux-team issue search keyword |
JSON 出力のキー名は gh --json 互換です(author.login,
assignees[].login, labels[].name, createdAt, mergedAt など)。
既存の jq パイプラインをそのまま使えます。
# 例: open PR の author 一覧を取得
cmux-team pr list --state open --json number,title,author.login
cmux-team gh sync
cmux-team gh sync --full
cmux-team gh status
--full 推奨--sync一発で同期 + 読み取りを行いたい場合は list/show に --sync を付けられます:
cmux-team issue list --state open --sync # 事前 incremental sync してから表示
cmux-team issue show 272 --sync # 対象 issue を同期してから表示
cmux-team start で起動する Manager ダッシュボードには「Issues」タブが
あります(キーバインド 5 または I)。
R — incremental sync を走らせるEnter / O — 選択中 issue を markdown ビューアで開くB — 選択中 issue の GitHub URL をブラウザで開く↑ / ↓ — カーソル移動gh を使う以下の操作は本 skill の対象外です。引き続き gh を使ってください:
gh issue create — issue 作成gh issue comment / gh pr comment — コメント追加gh issue close / gh pr close — クローズgh pr merge — マージgh pr review — レビュー送信書き込みを行った後は cmux-team gh sync でキャッシュを更新してください。
以下の場合、このスキルは使えません。従来通り gh を直接使ってください:
origin が GitHub / GHE でない(exit 2)gh auth login を実行するか、GITHUB_TOKEN / GH_TOKEN を設定cmux-team gh sync が exit 4 を返した場合、しばらく待って(reset_at
表示を参照)再度実行してください。cmux-team issue list --stale-ok で
警告を抑止して古いキャッシュから読み続けることも可能です。
| code | 意味 |
|---|---|
| 0 | 成功 |
| 1 | 汎用エラー |
| 2 | 非 git / 非 GitHub origin |
| 3 | 認証欠如 |
| 4 | rate limit 到達 |
.team/gh-cache.db(SQLite WAL)プロジェクト毎に独立したキャッシュを持つため、複数リポジトリを横断して
参照する用途には使えません(各リポジトリで個別に cmux-team start /
cmux-team gh sync を走らせてください)。
npx claudepluginhub hummer98/cmux-team --plugin cmux-teamProvides GitHub CLI commands with JSON output for AI agent workflows: PR checks/status, workflow runs/logs, issue details, repo ops.
Executes GitHub operations (PRs, issues, milestones, labels, comments, merges) using Python scripts with structured output and error handling. Use for pull requests, issues, review comments, CI checks, milestones instead of raw gh.
Executes GitHub operations on PRs, issues, milestones, labels, comments, and merges using Python scripts with structured output and error handling. Use for pull requests, issues, review comments, CI checks, or milestones instead of raw gh.