headlamp

Deploy and validate Headlamp Kubernetes web UI with AI plugin and Gateway API routing.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/villadalmine/infra --skill headlamp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headlamp
Source: https://github.com/villadalmine/infra/tree/main/.agents/skills/headlamp
Command: npx skills add https://github.com/villadalmine/infra --skill headlamp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams deploy and operate Headlamp as a unified Kubernetes web UI for cluster administration, reducing the friction of juggling multiple tools and manual access steps.

Core Features & Use Cases

  • In-cluster administration: Work with Headlamp deployed in the headlamp namespace using cluster-admin authentication and service-account based login.
  • AI plugin integration: Load both the official AI assistant plugin and a custom HolmesGPT plugin at startup, with configuration tailored to the in-cluster LiteLLM and model routing setup.
  • Gateway-based access: Validate and use the HTTPRoute and gateway domains that expose the UI over internal cluster routing.
  • Use case: An operator can quickly verify the Headlamp deployment, retrieve the admin token, and confirm that AI plugins are loading correctly after an update.

Quick Start

Use the headlamp skill to verify the Headlamp deployment, confirm plugin loading, and document the login and gateway access details for the cluster UI.

Frequently Asked Questions about headlamp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Headlamp for Kubernetes cluster administration?

To deploy Headlamp for Kubernetes cluster administration, apply the web UI configuration in the headlamp namespace using cluster-admin authentication and service-account based login. This validates the deployment and confirms gateway access.

How do I add AI plugins to a Headlamp Kubernetes web UI?

You add AI plugins to Headlamp by loading the official AI assistant and a custom HolmesGPT plugin at startup. This requires patching plugin configurations and connecting to an in-cluster LiteLLM setup for model routing.

Can I use Gateway API to expose the Headlamp UI in a cluster?

Yes, you can use Gateway API to expose the Headlamp UI in a cluster. The setup validates HTTPRoute and gateway domains to provide internal cluster routing for operator workflows over the web interface.

What permissions do I need to run Headlamp with HolmesGPT integration?

Running Headlamp with HolmesGPT integration requires cluster-admin authentication for in-cluster administration. You also need service-account based login credentials and plugin patching permissions to initialize the AI plugins.

How do I verify that Headlamp AI plugins are loading correctly after an update?

To verify Headlamp AI plugins are loading correctly after an update, use the skill to check the deployment status, retrieve the admin token, and confirm both the official AI assistant and HolmesGPT plugins initialize at startup.

What is Headlamp used for in Kubernetes cluster operator workflows?

Headlamp is used in Kubernetes cluster operator workflows to provide a unified web UI for cluster administration. It reduces the friction of juggling multiple tools by combining in-cluster management with AI-assisted HolmesGPT integration and Gateway API routing.