kubed 2.3.1

97% fewer tokens for AI agents to understand infra — layout index for Kubernetes, Docker, Terraform, Helm plus shell completions

Kubed

97% fewer tokens for AI agents to understand your infrastructure.

CLI and context tooling for Kubernetes, Docker, Terraform, and Helm. Kubed writes a single .kubed/layout.json that captures your entire infra layout—Dockerfiles, Terraform, Helm charts, K8s resources, project structure, and cross-repo shared infra. Agents read one ~1,500-token file instead of running 10+ discovery commands that consume 50,000+ tokens.

Without Kubed	With Kubed
~50,000+ tokens	~1,500 tokens
10+ tool calls	1 file read
Repeated discovery	Snapshot-based

• Docs: cmds.daleyarborough.com
• Layout index: kubed layout capture writes .kubed/layout.json; kubed layout show prints it. Schema: docs/LAYOUT_SCHEMA.md.

Installation (Python package)

pip install kubed
kubed-setup

Non-interactive: kubed-setup --force-yes. See cmds.daleyarborough.com for full docs.

Layout commands (Go binary)

Build the binary (requires Go 1.21+):

make build   # outputs build/kubed
# or: go build -o build/kubed ./cmd/kubed

• kubed layout capture — Connect to current kube context; index Deployments, Services, ConfigMaps, Secrets and their relationships; write .kubed/layout.json (or ~/.kubed/layout.json if not in a git repo). Optional: --all-namespaces.
• kubed layout show — Print layout.json to stdout. If missing, prints "run kubed layout capture" and exits 1.

Use .kubed/layout.json for infra layout; run kubed layout capture after cluster changes. This repo does not use Kubernetes; we validate layout with make test (fixture-based agent-query tests).

Development: test before pushing

Run make verify before pushing to main (same idea as Kubernetes: only working, quality code).

make verify   # runs go vet + tests (unit + agent-query tests)
make test     # tests only
make build    # build binary
make help     # list targets

Tests include agent-query tests: given a layout fixture, they assert that the data passed to an agent/LLM answers questions like "what workloads exist?", "what does service X select?", "what configmaps does deployment Y use?". See internal/layout/query_test.go.

---

Kubed Documentation (site)

This is the documentation website for the Kubed CLI tool, built with Jekyll and Tailwind CSS.

Setup

Prerequisites

• Ruby 2.7+ with Bundler
• Node.js 14+ with npm

Installation

1. Install Ruby dependencies:

bundle install

2. Install Node.js dependencies:

npm install

Development

To run the site locally with live reload:

npm run dev

You can then access the site at http://localhost:4000

Building for Production

npm run build:css
bundle exec jekyll build

The site will be generated in the _site directory.

Content

• index.md: The home page
• /docker/, /kubernetes/, /terraform/, /helm/: Tool-specific documentation
• installation.md: Installation instructions

---

License

MIT. See the LICENSE file for details.

Contributing

Contributions are welcome. Please open an issue or submit a pull request.

Contact

cmds.daleyarborough.com · [e-mail]