pr-tree

GitHub Pull Request をツリー表示するツール。CLI 版とデスクトップアプリ版（Electron）の2種類があります。

Desktop App (Electron)

macOS 向けの常駐型デスクトップアプリ。小さいウィンドウで PR ツリーをリアルタイム表示します。

セットアップ

cd pr-tree-app
npm install

起動

cd pr-tree-app
npm start

初期設定

初回起動時に設定パネルが表示されます。

1. Token - GitHub Personal Access Token（repo スコープ）を入力
   • https://github.com/settings/tokens から発行
2. Repositories - owner/repo 形式でリポジトリを追加（複数登録可）
3. Account - 自分の GitHub ユーザー名を入力（My PRs / Review Requested の分類に使用）
4. Interval (sec) - ポーリング間隔（秒）。デフォルト 60 秒
5. Save を押して保存

操作方法

ボタン	機能
☰	カード表示（My PRs / Review Requested をセクション分け）
🌳	ツリー表示（ブランチの親子関係をツリー構造で表示）
✅	承認済み PR の非表示トグル（Review Requested セクションのみ適用）
↻	手動更新
⚙	設定パネルの開閉

表示内容

• CI ステータス: 🟢 成功 / 🔴 失敗 / 🟡 実行中 / ⚪ 未実行
• 承認状態: ✅ 承認者名（2名以上の場合は +N 表示）
• コンフリクト: 💥 マージ不可
• ツリーバッジ: 🌳 クリックでスタック PR のツリー詳細を画面下部に表示

PR カードをクリックすると、ブラウザで該当 PR を開きます。

ビルド・パッケージ

cd pr-tree-app

# 開発時の起動（DevTools 付き）
npm run dev

# macOS アプリとしてパッケージング（ビルド → .app 生成 → /Applications にコピー）
npm run package

npm run package を実行すると /Applications/PRTree.app が生成され、Launchpad や Spotlight から起動できます。

---

CLI Version

コマンドラインで PR をツリー表示します。

セットアップ

• GitHub Personal Access Token（repo スコープ）を取得
  • https://github.com/settings/tokens
• 環境変数に追加

  export GITHUB_API_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

• bundle install を実行
• スクリプトを実行可能なパスに配置

  ln -s /path/to/pr-tree/bin/pr-tree /usr/local/bin/pr-tree

使い方

# 基本実行
$ pr-tree

# ユーザーで絞り込み
$ pr-tree -k username

# レビュアーで絞り込み
$ pr-tree -r username

# リポジトリURL指定
$ pr-tree -u ssh://git@github.com/owner/repo.git

# Markdown 形式で出力
$ pr-tree -m

# 変更ファイル表示
$ pr-tree -f

表示例