このプロジェクトについて

Smokeyは静的、単一ファイルの開発者ダッシュボードで、GitHubリポジトリの健康状態を監視します。ブラウザでindex.htmlを開き、GitHubのユーザー名または組織名を入力し、owner/repo形式でリポジトリをリストすると、ページはそれらの現在の状態を1つのソート可能なテーブルに表示します。目的は、GitHub内をクリックし回ることなくリポジトリの健康状態を確認することです。 テーブルに表示される内容 - 各リポジトリの最終プッシュ。デフォルトでは最も古いプッシュが最初に表示され、任意の列ヘッダー(リポジトリ、最終プッシュ、PR、issue)をクリックして再ソートできます。 - リポジトリ名の下に最新リリースのバージョンとリリース日が表示されます。 - オープンプルリクエストとオープンissueの数。数をクリックすると、そのリポジトリのフィルタ済みGitHubページが開きます。 - 注意バッジ:外部コントリビュータのアクティビティがあるリポジトリに対して、オープンPR用とオープンissue用の1行ずつ表示され、各バッジはフィルタ済みGitHubビューへリンクします。Botが作成したPR(たとえばgithub-actions[bot]からのものは自動的に除外されます。 認証 公開リポジトリはログインなしで読み込めます。設定パネルにGitHubパーソナルアクセストークンを追加すると、プライベートリポジトリとCIステータス列がロック解除され、SAML SSOで保護された組織リポジトリについてはトークンがその組織に対して認可されている必要があります。認証なしのAPIアクセスは1時間あたり60リクエストに制限され、各リポジトリは4リクエストを消費するため、約15の公開リポジトリを監視する段階でトークンが必要になります。認証済みトークンでは制限が1時間あたり5,000リクエストに引き上げられます。READMEでは、トークンはブラウザのlocalStorageにのみ保存され、api.github.comにのみ送信されると説明されています。クラシックトークン(repoスコープ)およびファイン・グレインドトークン(Contents: Read、Metadata: Read、Actions: Read(CIステータス用))についても記載されています。 トラフィックチャート GitHubのライブトラフィックAPIの代わりに、ダッシュボードは別の週次GitHub Actionsワークフロー(log-traffic.yml)によって毎日スナップショットを保持するtraffic-logブランチからフルヒストリーのトラフィックエリアチャートを描画します。チャートは最近の日を拡張する対数時間軸と平方根値スケールを使用します。このビューにはトークンは不要です。ブランチまたは記録された行がまだ存在しない場合は、トラフィック履歴がないと報告されます。 ホスティングとセットアップ ビルドステップ、依存関係のインストール、サーバーは不要です。GitHub Pagesにホストされたコピーが提供されているため、インストールなしでダッシュボードを利用できます。それ以外の場合はindex.htmlをダウンロードしてローカルで開くことができます。独自インスタンスを実行するには、リポジトリをフォークし、メインブランチのルートフォルダーでGitHub Pagesを有効にします。レイアウトはモバイルフレンドリーでコンパクトで、サイドバーはありません。 READMEにはトラブルシューティングも記載されています: staleなキャッシュページが持続的な"add a PAT"メッセージを表示する問題(ハードリフレッシュで解決。プライベートウィンドウではlocalStorageがクリアされる点に注意)、認証なしのレートリミットやSAML認可不足による403エラー、リポジトリ追加後にロギングワークフローが少なくとも1回実行されるまでトラフィックチャートが空のままになることなどです。 ライセンスと連絡先:MITライセンス、著作権2025 Scott Kirvan。貢献はissue、フォーク、プルリクエストを通じて歓迎され、連絡チャネルとしてLinkedInとDiscordサーバーがリストされています。リポジトリにはnotesフォルダーにCHANGELOGとTODOも含まれています。