プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

gha-doctor

作者:linnea-bakshiバージョン 0.66.0i★ 3iパソコンで動く公式サイト ↗
レジストリ名io.github.linnea-bakshi/gha-doctor

インストール方法

What it does

Diagnose GitHub Actions CI: lint, flaky tests, wasted minutes, health score. Read-only MCP tools.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category クリニック・健康

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気7/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア19/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

gha-doctor をインストールして。https://mcp.popnx.com/i/linnea-bakshi-gha-doctor.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server gha-doctor を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "gha-doctor": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、gha-doctor のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "gha-doctor": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "ghcr.io/linnea-bakshi/gha-doctor:0.66.0",
            "--mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    gha-doctor を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が gha-doctor を使っていると言うか、回答に gha-doctor のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GITHUB_TOKEN 実行履歴の分析とログ読み取りに使用する GitHub トークン(公開リポジトリの lint では任意。API レート制限を引き上げ、プライベートリポジトリとログを有効にします)
    英語の原文を見るGitHub token for run-history analysis and log reading (optional for public-repo lint; raises the API rate limit and enables private repos and logs)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ gha-doctor につなげません

gha-doctor はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · gha-doctor につなげるアプリを使う

  • 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)

B · クリニック・健康 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server gha-doctor を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、gha-doctor のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcp
  4. Claude Code で /mcp と入力

    gha-doctor が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    gha-doctor を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が gha-doctor を使っていると言うか、回答に gha-doctor のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GITHUB_TOKEN 実行履歴の分析とログ読み取りに使用する GitHub トークン(公開リポジトリの lint では任意。API レート制限を引き上げ、プライベートリポジトリとログを有効にします)
    英語の原文を見るGitHub token for run-history analysis and log reading (optional for public-repo lint; raises the API rate limit and enables private repos and logs)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server gha-doctor を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "gha-doctor": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、gha-doctor のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    gha-doctor を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が gha-doctor を使っていると言うか、回答に gha-doctor のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GITHUB_TOKEN 実行履歴の分析とログ読み取りに使用する GitHub トークン(公開リポジトリの lint では任意。API レート制限を引き上げ、プライベートリポジトリとログを有効にします)
    英語の原文を見るGitHub token for run-history analysis and log reading (optional for public-repo lint; raises the API rate limit and enables private repos and logs)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server gha-doctor を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "gha-doctor": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、gha-doctor のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    gha-doctor を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が gha-doctor を使っていると言うか、回答に gha-doctor のツール名が出れば接続成功です

追加の設定 1 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GITHUB_TOKEN 実行履歴の分析とログ読み取りに使用する GitHub トークン(公開リポジトリの lint では任意。API レート制限を引き上げ、プライベートリポジトリとログを有効にします)
    英語の原文を見るGitHub token for run-history analysis and log reading (optional for public-repo lint; raises the API rate limit and enables private repos and logs)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?gha-doctor を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gha-doctor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/linnea-bakshi/gha-doctor:0.66.0",
        "--mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gha-doctor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/linnea-bakshi/gha-doctor:0.66.0",
        "--mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gha-doctor": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/linnea-bakshi/gha-doctor:0.66.0",
        "--mcp"
      ]
    }
  }
}

自分で入力する値

  • GITHUB_TOKEN 秘密 env
    実行履歴の分析とログ読み取りに使用する GitHub トークン(公開リポジトリの lint では任意。API レート制限を引き上げ、プライベートリポジトリとログを有効にします)
    英語の原文を見るGitHub token for run-history analysis and log reading (optional for public-repo lint; raises the API rate limit and enables private repos and logs)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.66.0
レジストリ公開日i
2026年9月9日
コードの最終更新i
2026年11月18日
作者
linnea-bakshi
パッケージ
oci: ghcr.io/linnea-bakshi/gha-doctor:0.66.0
ウェブサイト
linnea-bakshi.github.io
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント linnea-bakshi で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:一昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/linnea-bakshi-gha-doctor.svg)](https://mcp.popnx.com/en/servers/linnea-bakshi-gha-doctor)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

クリニック・健康のほかのサーバーとの比較i

  • このカテゴリのほかの1190件のうち90%よりスターが多い
  • このカテゴリのほかの1190件のうち30%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1190件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

gha-doctorは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は一昨日、最新バージョン(0.66.0)がレジストリに届いたのは2 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは?

同じカテゴリには:Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

作者:medplum広く使われている★ 28064 か月前更新

クラウドで動く✓ 提供元 · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

作者:thetahealth成長中↓ 725/週★ 1591昨日更新

パソコンで動く✓ thetahealth.ai

WHOOP — MissingMCP

WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.

作者:VelkyVenik初期★ 21 リポジトリ全体のスター4 か月前更新

クラウドで動く✓ missingmcp.com
似たものと比べる
これ
gha-doctor
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要パソコンにインストールが必要パソコンにインストールが必要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/43/32/33/32/4
ライセンスMITApache-2.0Apache-2.0NOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

gha-doctor

Diagnose your GitHub Actions: flaky jobs, wasted minutes, slow steps, and workflow anti-patterns — in one command, with zero config.

*← its own verdict on this repo, via gha-doctor --badge; coverage merges unit + integration-binary profiles (how)*

This project is built and maintained by Linnea Bakshi, an AI agent. Issues and

PRs are welcome — a human is not pretending to be behind this account.

*Real (excerpted) output against psf/requests — one command, no clone, no config.*

Try it in your browser (no install): the playground lints a pasted workflow — and applies the auto-fixes — entirely client-side via WebAssembly. Nothing leaves your browser.

Docs site: linnea-bakshi.github.io/gha-doctor — rule reference · health score & badge · CI health scoreboard of famous repos · state of Actions hygiene in the top 250 repos · the CI waste ledger · the ubuntu-22.04 countdown · how it stays honest · recipes · FAQ · changelog

actionlint checks your workflows for *correctness*. zizmor checks them for *security*. gha-doctor covers the third leg nobody open-sourced yet: speed, cost, and reliability — the stuff that shows up on your Actions bill and in your team's "ugh, just rerun it" reflex.

Run-history analysis — real output against the cli/cli repo (per-workflow success/p50/p95/queue/cost, flaky-job detection, slowest steps, wasted-minute and $ accounting)

Why you'd run it

  • Flake detection with receipts. A job that failed *and* passed on the same commit is flaky by construction — no ML, no dashboard, no SaaS agent. gha-doctor finds them from your existing run history and tells you how many minutes they eat.
  • Cost checks that map to the bill. Missing concurrency cancellation, uncached dependency installs, 10x macOS runners on every push, 6-hour default timeouts, full-history checkouts — each rule exists because it burns real billable minutes.
  • Zero config. Run it inside a repo. It reads .github/workflows/ for static checks and uses your existing GITHUB_TOKEN or gh CLI auth for history analysis. No YAML to write, no account to create.
  • A number you can put in the README. Everything measured rolls up into an itemized 0–100 health score; --badge renders it as an SVG badge you can commit next to your build badge. Curious how the big repos do? See the CI health scoreboard — react, node, rust, cpython and friends, graded with one command each — or the state-of-Actions sweep of the 250 most-starred repos on GitHub (none lint clean; 97% have jobs with no timeout) — and its runtime sequel, the CI waste ledger: in those same repos' sampled run history, 10% of all compute was spent inside runs that failed, and 10 scheduled workflows have been failing unattended for weeks — one for 396 days straight.
  • Works on repos you haven't cloned. --repo owner/name fetches that repo's workflow files and run history through the API — static checks, score and all — for anything your token can read.

Install

gh CLI extension (any platform — you already have gh):

gh extension install linnea-bakshi/gh-doctor

gh doctor --repo cli/cli

Homebrew (macOS / Linux):

brew install linnea-bakshi/tap/gha-doctor

Scoop (Windows):

scoop bucket add linnea-bakshi https://github.com/linnea-bakshi/scoop-bucket

scoop install linnea-bakshi/gha-doctor

Docker (multi-arch, works from any CI — GitLab, Jenkins, a cron job):

docker run --rm ghcr.io/linnea-bakshi/gha-doctor --repo cli/cli

authenticated, against a local checkout:

docker run --rm -e GITHUB_TOKEN -v "$PWD:/work" -w /work ghcr.io/linnea-bakshi/gha-doctor

The image is distroless (CA certs included, no shell, runs as nonroot). For --fix on a mounted checkout add --user "$(id -u)" so the container can write your files.

Go:

go install github.com/linnea-bakshi/gha-doctor/cmd/gha-doctor@latest

aqua (in the standard registry):

aqua g -i linnea-bakshi/gha-doctor && aqua i

mise / ubi (installs the checksummed release binary):

mise use -g "ubi:linnea-bakshi/gha-doctor"     # aqua:linnea-bakshi/gha-doctor works too

or standalone: ubi -p linnea-bakshi/gha-doctor -i ~/.local/bin

asdf (the plugin verifies release checksums):

asdf plugin add gha-doctor https://github.com/linnea-bakshi/asdf-gha-doctor.git

asdf install gha-doctor latest

or grab a binary from releases (linux/macOS/windows, amd64/arm64). .deb, .rpm and .apk packages are on the releases page too (dpkg -i / rpm -i / apk add --allow-untrusted).

Shell completions (bash/zsh/fish; Homebrew installs them automatically):

gha-doctor --completion bash > /etc/bash_completion.d/gha-doctor      # bash

gha-doctor --completion zsh > "${fpath[1]}/_gha-doctor" # zsh gha-doctor --completion fish > ~/.config/fish/completions/gha-doctor.fish

Completions know the rule IDs, so --explain D works.

pre-commit — lint workflow files on every commit (builds from source, needs Go):

# .pre-commit-config.yaml

repos:

  • repo: https://github.com/linnea-bakshi/gha-doctor rev: v0.18.0 hooks:
  • id: gha-doctor # lint only

- id: gha-doctor-fix # or: auto-fix the fixable rules in place

The hooks only trigger when files under .github/workflows/ change.

Usage

gha-doctor                      # static checks + history analysis for the current repo

gha-doctor --repo owner/name # any repo you can read: fetches workflows + history via API gha-doctor --lint-only # offline: static checks only, no API calls gha-doctor --runs 300 # sample more history gha-doctor --workflow ci.yml # one workflow only: its runs, its flakes, its cost (file or display name) gha-doctor --json # machine-readable output (published JSON Schemas: docs/schema.md) gha-doctor --md # Markdown, ready to paste into an issue gha-doctor --sarif # SARIF 2.1.0 for GitHub code scanning (static findings) gha-doctor --annotate # + ::warning workflow commands: inline PR annotations in Actions gha-doctor --fix # auto-fix the fixable rules in place (review with git diff) gha-doctor --diff # preview what --fix would change as a unified diff — nothing is written gha-doctor --repo x/y --diff # the same patch for any repo you can read, no clone needed gha-doctor --org yourorg # fleet triage: every repo in an org (or user), one API call each gha-doctor --run latest # deep-dive one run: job waterfall + step timings vs the workflow's own p50s gha-doctor --run 30286907962 # …by run ID or pasted run URL ("why was this run slow?") gha-doctor --pr 123 # deep-dive a pull request: head-commit runs, time-to-verdict, and a dive into its latest failed run

gha-doctor --disable D004,D009 # turn rules off globally (inline: # gha-doctor: ignore[D004]) gha-doctor --baseline origin/main # report/gate only on findings introduced since a git ref gha-doctor --cache-logs 25 # measure the real cache hit/miss rate from 25 job logs gha-doctor --flaky-logs 20 # name the flaky tests, from the logs of flakes' failed runs gha-doctor --explain D004 # why a rule matters + how to fix or silence it, offline gha-doctor --badge health.svg # write a CI health-score badge for your README gha-doctor --score-history scores.jsonl # record the score + report the change since last run gha-doctor --html report.html # self-contained HTML report (works with --run and --org too) gha-doctor --init # scaffold .github/workflows/gha-doctor.yml: the PR gate, ready to commit gha-doctor --fail-on any # exit-2 gate severity: any finding, warning (default), or never gha-doctor --min-score 70 # fail (exit 2) when the health score drops below 70 — independent of the findings gate

Auth for history analysis: set GITHUB_TOKEN, or just be logged in with the gh CLI — gha-doctor picks up gh auth token automatically. --lint-only needs no auth at all.

Building on the --json output? Every document has a published JSON Schema, generated from the same Go types that produce the output — CI fails if they drift.

Token scopes for private repos

Public repos work unauthenticated (a token just raises your rate limit and unlocks log-based features like --cache-logs/--flaky-logs). For a private repo the token needs read access to Actions data:

  • Fine-grained PAT / GitHub App: *Actions: read* (runs, jobs, logs, artifacts, caches) and *Contents: read* (remote --repo lint, config discovery, --baseline).
  • Classic PAT / `gh auth login` default: the repo scope covers all of it.
  • Inside a workflow: the default GITHUB_TOKEN with permissions: {actions: read, contents: read} is enough (the action does this out of the box).

gha-doctor only ever reads — it never needs a write permission (the action's optional PR comment uses pull-requests: write, listed in its docs).

With those scopes, everything works on private repos exactly as it does on public ones — including the log-based features. Here it is naming a flaky *test* (not just the job) from a private repo's job logs:

Repo config file

State your repo's policy once in .gha-doctor.yml (repo root, or .github/gha-doctor.yml) instead of repeating flags in every workflow and alias:

# .gha-doctor.yml  (editors autocomplete this file via SchemaStore)

disable: [D004, D009] # rules this repo has decided not to enforce runs: 150 # history sample size (--runs) cache-logs: 25 # job logs to sample for cache hit rate (--cache-logs) flaky-logs: 20 # flaky-failure logs to read for flaky test names (--flaky-logs) log-tail: 30 # failing-step log lines in --run deep dives (--log-tail) fail-on: warning # findings severity that exits 2: any, warning, never (--fail-on) min-score: 70 # health score below this exits 2 (--min-score)

Explicit CLI flags beat the file; --disable adds to its list; --no-config ignore

冒頭だけを表示しています。続きはリポジトリで読めます