kubectl-cost is a kubectl plugin written in Go that provides command-line access to Kubernetes cost information through Kubecost's APIs. The tool enables developers, DevOps engineers, and other users to quickly determine the cost and efficiency of Kubernetes workloads by querying historical cost data and generating cost projections. The plugin integrates with Kubecost deployments in Kubernetes clusters and also works with OpenCost, an open-source alternative, making it accessible to a broader range of users.
The repository offers multiple aggregation-based cost monitoring subcommands including namespace, deployment, controller, label, pod, and node. Each subcommand operates in two modes: rate mode, which displays projected monthly costs based on activity during a specified window, and historical mode, which shows actual costs incurred over a time period. The tool supports detailed cost breakdowns across multiple dimensions including CPU, memory, GPU, persistent volume, and network costs. A newer feature introduced in Kubecost v1.100 allows users to predict the cost implications of undeployed changes by analyzing YAML specifications for Pod, Deployment, and StatefulSet workloads. Additionally, the plugin includes an experimental terminal user interface mode for interactive cost exploration.
Installation is straightforward through multiple channels. Users can install kubectl-cost via Krew, the kubectl plugin manager, or by downloading pre-built binaries from the releases page for Linux, macOS, and Windows systems. The tool requires a running Kubecost deployment in the cluster and supports Kubernetes version 1.8 or higher. The plugin automatically discovers Kubecost services and handles port forwarding transparently to provide a seamless user experience, though legacy proxy behavior is available for environments with specific security constraints.
GitGenius activity data reveals that the repository maintains active community engagement with a median issue and pull request response latency of approximately 190 hours, though some items experience longer resolution times. The most frequently applied issue labels are needs-triage, enhancement, and good first issue, indicating ongoing development and community contributions. Key contributors tracked by GitGenius include AjayTripathy, HibAwad, and cliffcolvin, each with ten recorded events. The repository shares overlapping contributors with related projects including kubecost/kubecost, opencost/opencost, and argoproj/argo-rollouts, suggesting an interconnected ecosystem of cost management and deployment tools.
The tool is classified across numerous cost management and infrastructure monitoring categories including cost analysis, cloud cost optimization, spending insights, cost allocation, pod expense tracking, and resource optimization. This broad classification reflects the plugin's comprehensive approach to Kubernetes cost visibility. The implementation includes debugging capabilities through log-level configuration, allowing users to troubleshoot issues by enabling debug-level logging. The repository provides extensive documentation through built-in help commands for each subcommand and includes guidance for handling common configuration scenarios, such as working with non-standard Kubecost deployments in different namespaces or with custom service names.
