# Install kubespy with Homebrew, MacPorts, Nix, scoop, zypper

Tools for observing Kubernetes resources in realtime. Version 0.6.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:kubespy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install kubespy
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install kubespy
```

  Evidence: MacPorts ports tree: sysutils/kubespy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kubespy
```

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

- zypper (92%):

```sh
sudo zypper install kubespy
```

  Evidence: openSUSE Tumbleweed package metadata: kubespy from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install extras/kubespy
```

  Evidence: Scoop official bucket manifest trees: bucket/kubespy.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:kubespy
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/kubespy>
- **Version:** 0.6.3
- **Source summary:** Tools for observing Kubernetes resources in realtime
- **Homepage:** <https://github.com/pulumi/kubespy>
- **Repository:** <https://github.com/pulumi/kubespy>
- **Upstream docs:** <https://github.com/pulumi/kubespy#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/pulumi/kubespy/archive/refs/tags/v0.6.3.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- kubespy (cli)
- kubespy (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.6.3
- Local data: ok
- Upstream repository: https://github.com/pulumi/kubespy
- Upstream latest detected: v0.6.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

kubespy is a Pulumi-origin Kubernetes diagnostic CLI for watching API objects change in real time. Its package-nerd appeal is that it exposes Kubernetes controller behavior from the terminal instead of hiding rollout state behind a dashboard or a single kubectl status line.

### Project history

Pulumi introduced kubespy publicly on September 18, 2018 as a small tool for displaying changes made to Kubernetes objects in real time. The repository README says the tool grew out of Pulumi CLI work on making Kubernetes deployments predictable, and the command set settled around status, changes, trace, and record views over arbitrary Kubernetes resources.

### Adoption history

kubespy remained a focused utility rather than a broad platform. Its GitHub repository accumulated thousands of stars and packaging across Homebrew, MacPorts, Nix, Scoop, and zypper metadata, which fits the pattern of a CLI that is useful during debugging but not usually installed as a cluster component.

### How it is used

Users run kubespy against a resource such as a Pod, Service, or Deployment to see status diffs, object changes, or a higher-level trace of related resources. The README also documents use as a kubectl plugin by installing it as kubectl-spy, reflecting the Kubernetes 1.12 plugin convention.

### Why package nerds care

kubespy is notable because it packages Kubernetes watch/discovery-client behavior as a small observability command. It sits in the same mental drawer as kubectl get -w, stern, and k9s, but it is narrower: it is about making controller transitions readable during rollout and failure analysis.

### Timeline

- 2018: Pulumi announced kubespy with a blog post on watching Pod lifecycle changes.
- 2018: Follow-up Pulumi posts used kubespy trace to explain Services and Deployments.
- 2024: The GitHub release page listed v0.6.3 with ARM64 support.

### Related projects

- Related tools include Pulumi CLI, kubectl, Kubernetes external kubectl plugins, stern-style log tailers, and TUI dashboards such as k9s. kubespy is narrower than those tools because it focuses on object-status evolution rather than log aggregation or full cluster browsing.

### Sources

- <https://formulae.brew.sh/formula/kubespy>
- <https://github.com/pulumi/kubespy>
- <https://github.com/pulumi/kubespy/releases>
- <https://www.pulumi.com/blog/kubespy-and-the-lifecycle-of-a-kubernetes-pod-in-four-images/>
- <https://www.pulumi.com/blog/kubespy-trace-a-real-time-view-into-the-heart-of-a-kubernetes-service/>


## Security Notes

infrastructure mutation or orchestration signal.

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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** kubespy
- **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 - kubespy: normalized package name match | nixpkgs package indexes: pkgs/by-name/ku/kubespy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - kubespy - 0.6.3-1.6: normalized package name match | openSUSE Tumbleweed package metadata: kubespy from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Tools for observing Kubernetes resources in real time, powered by Pulumi | https://github.com/pulumi/kubespy
- MacPorts - kubespy: normalized package name match | MacPorts ports tree: sysutils/kubespy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/kubespy: normalized package name match | Scoop official bucket manifest trees: bucket/kubespy.json from https://api.github.com/repos/ScoopInstaller/Extras/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.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [linkerd](https://www.automicvault.com/pkg/brew/linkerd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes, observability.
- [cdk8s](https://www.automicvault.com/pkg/brew/cdk8s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [chaoskube](https://www.automicvault.com/pkg/brew/chaoskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [click](https://www.automicvault.com/pkg/brew/click/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cloud-provider-kind](https://www.automicvault.com/pkg/brew/cloud-provider-kind/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterawsadm](https://www.automicvault.com/pkg/brew/clusterawsadm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [kubetui](https://www.automicvault.com/pkg/brew/kubetui/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.
- [gwctl](https://www.automicvault.com/pkg/brew/gwctl/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.
- [ingress2gateway](https://www.automicvault.com/pkg/brew/ingress2gateway/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
