Kubed

CLI and context tooling for Kubernetes, Docker, Terraform, and Helm. A file-based, agent-friendly infra layout index so tools don't need to run kubectl for discovery—plus shell completions and aliases to keep you in flow.

97%
fewer tokens per query
1
file instead of 10+ tool calls
~1.5K
tokens vs ~50K+ for discovery

The problem

AI agents burn thousands of tokens just to understand your infrastructure. Every kubectl get, find, and ls -laR adds latency and cost. A single workspace exploration can consume 50,000+ tokens before answering one question.

The solution

Kubed writes a single .kubed/layout.json that captures your entire infrastructure layout: Dockerfiles, Terraform, Helm charts, Kubernetes resources, project structure, and cross-repo shared infra. Agents read one ~1,500-token file instead of running discovery commands.

The layout is section-based with IDs and tags, so agents can query specific parts (e.g., "section id=infra_paths") without loading the entire file.

For humans, Kubed installs shell completions and aliases for Docker, Kubernetes, Terraform, and Helm so you stay productive at the terminal.

Tools

Get started

Install Kubed and run setup for your shell. Restart your terminal after installation for changes to take effect.

Terminal
pip install kubed
kubed-setup
Non-interactive
pip install kubed
kubed-setup --force-yes

Restart your terminal after installation for changes to take effect.

Full installation guide

Found an error or have a suggestion?

Report an issue