# Install kubectl-ai with Homebrew, Nix

AI powered Kubernetes Assistant. Version 0.0.31 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:kubectl-ai
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install kubectl-ai
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kubectl-ai
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ku/kubectl-ai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:kubectl-ai
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/kubectl-ai>
- **Version:** 0.0.31
- **Source summary:** AI powered Kubernetes Assistant
- **Homepage:** <https://github.com/GoogleCloudPlatform/kubectl-ai>
- **Repository:** <https://github.com/GoogleCloudPlatform/kubectl-ai>
- **Upstream docs:** <https://github.com/GoogleCloudPlatform/kubectl-ai#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/GoogleCloudPlatform/kubectl-ai/archive/refs/tags/v0.0.31.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- kubectl-ai (cli)
- kubectl-ai (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.0.31
- Local data: ok
- Upstream repository: https://github.com/GoogleCloudPlatform/kubectl-ai
- Upstream latest detected: v0.0.31 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

kubectl-ai is Google's AI-assisted Kubernetes command-line assistant. It translates natural-language intent into Kubernetes operations and can run as an interactive shell, stdin-driven command, kubectl plugin via Krew, MCP client, or MCP server.

### Project history

The GitHub repository was created on 2025-01-20 under the GoogleCloudPlatform organization. Its README framed the tool around making Kubernetes management more accessible by turning user intent into precise operations, while still requiring kubectl to be installed and configured.

The project evolved quickly through many 0.0.x releases during 2025 and early 2026, adding provider breadth and integration modes rather than presenting itself as a stable, long-lived Kubernetes subcommand.

### Adoption history

kubectl-ai sits at the intersection of two high-adoption operator habits: kubectl-centric cluster work and AI-assisted terminal workflows. The README documents Gemini, Vertex AI, Azure OpenAI, OpenAI, Grok, Bedrock, Ollama, and llama.cpp support, which made the tool usable across hosted and local model setups.

The repository metadata observed on 2026-07-01 showed more than 7000 GitHub stars, a strong early signal for a project created in 2025.

### How it is used

Users run `kubectl-ai` interactively, pass a task as an argument with quiet mode, pipe prompt text through stdin, or install it as the `kubectl ai` plugin via Krew. The README also describes environment-variable API keys for hosted providers and local model options for Ollama and llama.cpp.

Its package-manager role is to put an AI command generator and executor beside kubectl rather than inside the cluster, so installation is a developer-workstation concern.

### Why package nerds care

For package nerds, kubectl-ai is a marker of the 2025 shift from Kubernetes CLIs that only wrap APIs to CLIs that broker human intent through LLM providers. The package is interesting because it carries both classic kubectl-plugin distribution and newer MCP integration in one small binary workflow.

### Timeline

- 2025-01-20: GitHub repository created.
- 2025: README documented Krew installation as `kubectl krew install ai` and invocation as `kubectl ai`.
- 2025-11-03: Release v0.0.27 published.
- 2026-01-21: Release v0.0.29 published.
- 2026-03-27: Release v0.0.31 published.

### Related projects

- kubectl, Krew, MCP, Gemini, Vertex AI, OpenAI-compatible APIs, Bedrock, Ollama, and llama.cpp form the surrounding ecosystem. Unlike kubectl plugins that expose one Kubernetes resource domain, kubectl-ai is a general assistant layered over Kubernetes operations.

### Sources

- <https://api.github.com/repos/GoogleCloudPlatform/kubectl-ai>
- <https://github.com/GoogleCloudPlatform/kubectl-ai>
- <https://github.com/GoogleCloudPlatform/kubectl-ai#readme>
- <https://github.com/GoogleCloudPlatform/kubectl-ai/tree/main/docs>
- <https://krew.sigs.k8s.io/docs/user-guide/setup/install/>
- <https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/kubectl-ai/config.yaml, ~/.config/kubectl-ai/tools.yaml, ~/.config/kubectl-ai/mcp.yaml, ~/.kube/config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** kubectl-ai
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - kubectl-ai: normalized package name match | nixpkgs package indexes: pkgs/by-name/ku/kubectl-ai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [krew](https://www.automicvault.com/pkg/brew/krew/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubecm](https://www.automicvault.com/pkg/brew/kubecm/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubecolor](https://www.automicvault.com/pkg/brew/kubecolor/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubectl-tree](https://www.automicvault.com/pkg/brew/kubectl-tree/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubectx](https://www.automicvault.com/pkg/brew/kubectx/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubelogin](https://www.automicvault.com/pkg/brew/kubelogin/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubergrunt](https://www.automicvault.com/pkg/brew/kubergrunt/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.
- [kubernetes-cli](https://www.automicvault.com/pkg/brew/kubernetes-cli/) - Shares av.db curated category or tags: cli, developer-tools, kubectl, kubernetes.

## Combined YAML source

View the package source record on GitHub. [combined/kubectl-ai.yml](https://github.com/automic-vault/db/blob/main/combined/kubectl-ai.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
