Medplum MCP
Securely access and manage FHIR healthcare data stored in Medplum.
Diagnose GitHub Actions CI: lint, flaky tests, wasted minutes, health score. Read-only MCP tools.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 7/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 19/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala gha-doctor. Sigue https://mcp.popnx.com/i/linnea-bakshi-gha-doctor.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server gha-doctor para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "gha-doctor": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de gha-doctor aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
SettingsDeveloperEdit Config
{
"mcpServers": {
"gha-doctor": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/linnea-bakshi/gha-doctor:0.66.0",
"--mcp"
]
}
}
}Usa gha-doctor y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando gha-doctor o muestra una herramienta de gha-doctor en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GITHUB_TOKEN Token de GitHub para el análisis del historial de ejecuciones y la lectura de registros (opcional para lint de repositorios públicos; aumenta el límite de la API y habilita repositorios privados y registros) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar gha-doctor
gha-doctor se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar gha-doctor
B · Otros en Clínicas y salud que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server gha-doctor para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de gha-doctor aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcpDeberías ver gha-doctor en la lista como conectado
Usa gha-doctor y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando gha-doctor o muestra una herramienta de gha-doctor en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GITHUB_TOKEN Token de GitHub para el análisis del historial de ejecuciones y la lectura de registros (opcional para lint de repositorios públicos; aumenta el límite de la API y habilita repositorios privados y registros) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server gha-doctor para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "gha-doctor": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de gha-doctor aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Usa gha-doctor y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando gha-doctor o muestra una herramienta de gha-doctor en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GITHUB_TOKEN Token de GitHub para el análisis del historial de ejecuciones y la lectura de registros (opcional para lint de repositorios públicos; aumenta el límite de la API y habilita repositorios privados y registros) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server gha-doctor para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "gha-doctor": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/linnea-bakshi/gha-doctor:0.66.0", "--mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de gha-doctor aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Usa gha-doctor y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando gha-doctor o muestra una herramienta de gha-doctor en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GITHUB_TOKEN Token de GitHub para el análisis del historial de ejecuciones y la lectura de registros (opcional para lint de repositorios públicos; aumenta el límite de la API y habilita repositorios privados y registros) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user gha-doctor -- docker run -i --rm ghcr.io/linnea-bakshi/gha-doctor:0.66.0 --mcpClaude 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 secreto envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
oci: ghcr.io/linnea-bakshi/gha-doctor:0.66.0Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub linnea-bakshi, dueña del repo
Último cambio de código: anteayer
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
No revisado: solo se pueden revisar paquetes npm y PyPI con versión
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/linnea-bakshi-gha-doctor)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (0.66.0) llegó al registro hace 2 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.
En la misma categoría: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Securely access and manage FHIR healthcare data stored in Medplum.
Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.
An MCP server that provides CodeScene Code Health analysis tools.
Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
| Este gha-doctor | Medplum MCP | Mirobody | Codescene MCP Server | Marrow | WHOOP — MissingMCP | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Se instala en tu equipo | Se instala en tu equipo | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/3 | 3/3 | 2/4 |
| Licencia | MIT | Apache-2.0 | Apache-2.0 | NOASSERTION | MIT | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
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)
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..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.--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.--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.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
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
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:
The hooks only trigger when files under .github/workflows/ change.
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.
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:
--repo lint, config discovery, --baseline).repo scope covers all of it.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:
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