mcpField
K
kubesearch

kubesearch

github.com/ionfuryCloud & DevOps2544 installsUpdated today
Repository

About kubesearch

kubesearch is a research skill for finding real Helm configurations in homelab repositories through kubesearch.dev. It helps Kubernetes homelab operators compare relevant releases and inspect linked GitHub HelmRelease files using recency, stars, chart versions, and infrastructure goals as selection criteria.

Key features

  1. 01Search Helm chart releases
  2. 02Find repositories linked to releases
  3. 03Fetch raw HelmRelease configurations
  4. 04Filter examples by recency and stars
  5. 05Compare chart versions and infrastructure goals

Use cases

  1. 01Research a Helm chart before configuring it
  2. 02Find homelab examples for Flux or Talos
  3. 03Compare configurations from related repositories

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ionfury/homelab --skill kubesearch

After installing, type/kubesearchin Claude Code to confirm it loaded.

Bundled filesreferences/output-format.mdtests.yaml

Details

From the project README

KubeSearch - Homelab Helm Configuration Research

Search kubesearch.dev to find real-world Helm configurations from other homelab repositories.

Workflow

Step 1 — Find chart: WebFetch https://kubesearch.dev/?search=<chart-name> → list matching releases with registry paths.

Step 2 — Get repository links: Convert registry path to URL format (replace / with -), then WebFetch https://kubesearch.dev/hr/<url-path> → list repositories with direct GitHub links to HelmRelease files.

Examples of the URL conversion:

  • ghcr.io/grafana-helm-charts/grafana → ghcr.io-grafana-helm-charts-grafana
  • charts.longhorn.io/longhorn → charts.longhorn.io-longhorn

Step 3 — Fetch configs: Convert GitHub blob URLs to raw URLs, then fetch 3-5 in parallel:

  • Blob: github.com/<owner>/<repo>/blob/<branch>/<path>
  • Raw: raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>

Selection criteria: recent activity (within 6 months), higher star count, similar chart version, similar infrastructure goals (bare-metal, GitOps, Talos).

Common Homelab Repositories

RepositoryFocus
onedr0p/home-opsFlux GitOps, extensive automation
bjw-s/home-opsApp-template patterns
buroa/k8s-gitopsTalos + Flux
mirceanton/home-opsWell-documented configs

See references/output-format.md for the standard output structure when presenting findings.

Comments

Markdown supported