# kubernetes-sigs/headlamp — health index 96/100 (Exceptional)

> Inspection of the public repository kubernetes-sigs/headlamp by inspect.software. It holds a health index of 96 out of 100, placing it in the Exceptional band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/kubernetes-sigs/headlamp
- Report page: https://inspect.software/software/kubernetes-sigs/headlamp
- Full JSON report: https://inspect.software/api/repositories/kubernetes-sigs/headlamp/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/k/kubernetes-sigs/headlamp.svg
- Inspected: 2026-09-19
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 96/100 | Exceptional |
| Community & Adoption | 17% | 93/100 | Exceptional |
| Sustainability & Governance | 23% | 76/100 | Good |
| Engineering Quality | 19% | 84/100 | Excellent |
| Security | 16% | 73/100 | Good |
| AI Readiness | 4% | 79/100 | Good |

The weighted overall 84 is calibrated to 96 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | A Kubernetes web UI that is fully-featured, user-friendly and extensible |
| Classification | library, network-service, web-ui, cli |
| Homepage | https://headlamp.dev |
| Primary language | TypeScript |
| License | Apache-2.0 |
| Stars | 7,304 |
| Forks | 1,112 |
| Created | 2019-11-08 |
| Last push | 2026-09-17 |
| Latest release | headlamp-helm-0.45.0 |
| Commits (last year) | 3,367 |
| Bus factor | 2 |
| Topics | kinvolk, kubernetes, headlamp, plugins, dashboard, kubernetes-ui, cloud-native, debugging, k8s, kubernetes-dashboard, kubernetes-monitoring, orchestration, kubernetes-debugging, devops |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| go | github.com/kubernetes-sigs/headlamp | v0.45.0 | — |
| npm | headlamp | 0.1.60 | 240 |
| npm | e2e-tests | 1.5.0 | 365 |
| npm | @headlamp-k8s/eslint-config | 0.7.0 | 49,120 |

## Vitality — 96/100 (Exceptional)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 1 days ago |
| Commit cadence | met | 36 / 36 | 52/52 weeks with commits |
| Commit volume | met | 18 / 18 | 3367 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | met | 36 / 36 | latest release 29 days ago |
| Release cadence | met | 27 / 27 | a release every ~16.4 days |
| OpenSSF Scorecard: Signed-Releases | not met | 0 / 10 | Project has not signed or included provenance with any releases. |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 1 days ago |

## Community & Adoption — 93/100 (Exceptional)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 93/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | met | 60 / 60 | 7,304 stars |
| Forks | met | 25 / 25 | 1,112 forks |
| Watchers | partial | 7.9 / 15 | 27 watchers |

### Community health — 92/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (Apache-2.0) |
| CONTRIBUTING guide | met | 18 / 18 | — |
| Code of conduct | met | 13.5 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | met | 6.3 / 6.3 | — |

## Sustainability & Governance — 76/100 (Good)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 64/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 25.2 / 54 | 2 contributor(s) cover half of all commits |
| Commit distribution | partial | 15 / 22.5 | top contributor authored 33% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 98 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 38 contributing companies or organizations |

### Issue & PR responsiveness — 69/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 29.9 / 42 | 71% of issues closed |
| PR acceptance | partial | 21.6 / 30 | 3104/4314 decided PRs merged |
| Newcomer PR acceptance | partial | 2.6 / 13 | 1/5 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | met | 15 / 15 | all changesets reviewed |

### Ownership & stewardship — 80/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | met | 25 / 25 | 4,683 followers of kubernetes-sigs |
| Track record | met | 25 / 25 | 208 public repos, account ~8 yr old |

### Package maintenance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 2 package(s) on go, npm |
| Publish recency | met | 35 / 35 | latest publish 29 days ago |
| Version history | met | 20 / 20 | 69 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 84/100 (Excellent)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 80/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 25 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | met | 16 / 16 | .eslintrc.yml, .golangci.yml, app/package.json ("prettier"), frontend/package.json ("eslintConfig", "prettier") |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | partial | 16 / 20 | 8 out of 9 merged PRs checked by a CI test -- score normalized to 8 |

### Documentation — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://headlamp.dev |
| Repository description | met | 10 / 10 | — |
| Topics | met | 10 / 10 | 14 topics |
| Wiki | not met | 0 / 10 | — |

## Security — 73/100 (Good)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 73/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 1.5 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | partial | 2 / 2.5 | 8 out of 9 merged PRs checked by a CI test -- score normalized to 8 |
| CII-Best-Practices | partial | 1.2 / 2.5 | badge detected: Passing |
| Code-Review | met | 7.5 / 7.5 | all changesets reviewed |
| Contributors | met | 2.5 / 2.5 | project has 38 contributing companies or organizations |
| Dangerous-Workflow | met | 10 / 10 | no dangerous workflow patterns detected |
| Dependency-Update-Tool | met | 7.5 / 7.5 | update tool detected |
| Fuzzing | met | 5 / 5 | project is fuzzed |
| License | met | 2.5 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | met | 5 / 5 | packaging workflow detected |
| Pinned-Dependencies | partial | 4.5 / 5 | dependency not pinned by hash detected -- score normalized to 9 |
| SAST | not met | 0 / 5 | SAST tool is not run on all commits -- score normalized to 0 |
| Security-Policy | met | 5 / 5 | security policy file detected |
| Signed-Releases | not met | 0 / 7.5 | Project has not signed or included provenance with any releases. |
| Token-Permissions | met | 7.5 / 7.5 | GitHub workflow tokens follow principle of least privilege |
| Vulnerabilities | not met | 0 / 7.5 | 83 existing vulnerabilities detected |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 79/100 (Good)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 85/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | .github/copilot-instructions.md, AGENTS.md, plugins/headlamp-plugin/template/AGENTS.md |
| Machine-readable docs (llms.txt) | not met | 0 / 15 | — |
| Legible commit history | met | 40 / 40 | 90 of 98 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 81/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | met | 18 / 18 | Makefile, eslint-config/Makefile |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | .eslintrc.yml, .golangci.yml, app/package.json ("prettier"), frontend/package.json ("eslintConfig", "prettier") |
| Static type checking | met | 11 / 11 | app/tsconfig.json, frontend/scripts/tsconfig.json, frontend/tsconfig.json, plugins/examples/activity/tsconfig.json, plugins/examples/app-menus/tsconfig.json, plugins/examples/change-logo/tsconfig.json, plugins/examples/cluster-chooser/tsconfig.json, plugins/examples/custom-theme/tsconfig.json, plugins/examples/customizing-map/tsconfig.json, plugins/examples/details-view/tsconfig.json, plugins/examples/dynamic-clusters/tsconfig.json, plugins/examples/headlamp-events/tsconfig.json, plugins/examples/pod-counter/tsconfig.json, plugins/examples/projects/tsconfig.json, plugins/examples/resource-charts/tsconfig.json, plugins/examples/secure-storage/tsconfig.json, plugins/examples/sidebar/tsconfig.json, plugins/examples/tables/tsconfig.json, plugins/examples/ui-panels/tsconfig.json, plugins/headlamp-plugin/template/tsconfig.json, plugins/headlamp-plugin/tsconfig.json, tools/i18n/tsconfig.json, tools/releaser/tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | not met | 0 / 10 | no agent-authored commits among the last 100 |
| Automated maintenance | not met | 0 / 8 | no automated dependency updates observed |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 9 / 10 | dependency not pinned by hash detected -- score normalized to 9 |

### Code legibility for models — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | TypeScript (statically typed) |
| Manageable file sizes | partial | 54.7 / 55 | 8/1505 source files over 60KB |

### Machine-readable interfaces — 40/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | not met | 0 / 40 | — |
| MCP server | not met | 0 / 20 | — |
| Runnable examples | met | 40 / 40 | examples |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- First-time contributor figures cover 12 of 14 authors (cap 12)
- npm package 'headlamp' points at a different repository (https://github.com/dbpiper/headlamp); excluded from ecosystem scoring
- Could not fetch npm package '@kinvolk/headlamp-load-tests' from its registry
- npm package '@headlamp-k8s/eslint-config' points at a different repository (https://github.com/headlamp-k8s/headlamp); excluded from ecosystem scoring
- GitHub dependency-graph SBOM request failed: GitHub API error 500 for /repos/kubernetes-sigs/headlamp/dependency-graph/sbom

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt