derailed/k9s
68.3
Adequate · 13 November 2026
43.5k
lines of production code
Go
primary language
8
measurements over time
What this system is
Features
Add info command to display configuration paths and screen dump directory
Users can now run the \k9s info\ command to view a summary of K9s configuration details, including the version, paths to configuration files (such as custom views, plugins, hotkeys, and skins), and the screen dump directory. The screen dump directory path is dynamically determined by reading the \screenDumpDir\ setting from the K9s configuration file, falling back to the default if not specified or if the config file is invalid. This provides a convenient way to locate where K9s stores its data and logs.
cmd · high confidence
Add internal vulnerability scanning engine
The \internal/vul\ package introduces the core logic for scanning container images for vulnerabilities using the Grype library. This change adds the \imageScanner\ component responsible for initializing the vulnerability database, enqueuing images for asynchronous scanning, and managing scan results. It includes the \Scan\ and \Scans\ types to track per-image findings, a \tally\ system to count vulnerabilities by severity (Critical, High, Medium, Low, Negligible), and a \scorer\ to aggregate risk. The \table\ component handles formatting and deduplicating the output, while \types.go\ defines severity constants. Tests are added for the scoring and table sorting logic.
internal/vul · high confidence
Add kubectl plugin to purge Helm releases
A new kubectl plugin named 'purge' has been added to the kubectl plugin directory. This script allows users to delete and purge a Helm release associated with a specific pod by extracting the release name from the pod's description and executing 'helm delete --purge'. It requires the TILLER\_NS environment variable to be set and accepts namespace and pod name as arguments.
plugins/kubectl · high confidence
Add kubectl-jq plugin for colored log parsing
A new kubectl-jq plugin has been added to the plugins/kubectl-plugins directory. This script processes kubectl logs by attempting to parse JSON output; if the line is not valid JSON, it displays the raw text in red color to distinguish it from structured log entries.
plugins/kubectl-plugins · high confidence
Introduce OSC-52 clipboard backend with native fallback
Users can now copy text to the system clipboard via the OSC-52 terminal escape sequence, providing a reliable alternative when native clipboard tools are unavailable. The clipboard behavior is controlled by the K9S\_CLIPBOARD environment variable, which accepts 'auto' (default, tries native then OSC-52), 'native', or 'osc52'. The maximum encoded payload size for OSC-52 can be tuned via the K9S\_OSC52\_MAX environment variable, and the implementation includes specific passthrough handling for tmux and GNU screen terminals.
internal/view · high confidence
Introduce internal watch package for resource informers and port-forward management
The \internal/watch\ package has been added to centralize the management of Kubernetes resource informers and active port-forward connections. This new component provides a \Factory\ for initializing and tracking dynamic shared informers per namespace, enabling efficient caching and retrieval of cluster resources. It also introduces a \Forwarders\ registry to track, start, and cleanly terminate port-forward sessions, ensuring that forwarders are properly removed when associated pods are deleted or killed.
internal/watch · high confidence
Introduce model1 package for tabular resource rendering
This change introduces the \internal/model1\ package, a new internal model layer for rendering Kubernetes resources in tabular views. It provides core data structures for table data, headers, rows, and row events, along with logic for computing deltas between resource states, applying custom column layouts, and handling row coloring based on resource validity and event type (add, update, delete). The package also includes a parallel worker pool for batch rendering to improve performance and comprehensive tests for the new functionality.
internal/model1 · high confidence
New UTF-8 aware color highlighting for log search results
The internal color package now includes a new \Highlight\ function that applies ANSI 256-color codes to specific byte ranges within log output. This implementation is specifically designed to handle UTF-8 character boundaries correctly, ensuring that multi-byte characters are highlighted as whole units rather than being corrupted by partial byte coloring. This capability supports the improved log search and highlighting experience, allowing users to see search matches rendered clearly in the terminal without encoding artifacts.
internal/color · high confidence
New benchmarking capability for performance testing
A new benchmarking module has been added to the internal performance tools, allowing users to run HTTP-based load tests against a target endpoint. This feature supports configurable concurrency and request counts, basic authentication, custom HTTP headers, and HTTP/2. Benchmark results are automatically saved as text files in a cluster-specific directory, with a built-in timeout to prevent indefinite hangs.
internal/perf · high confidence
New dialog components for confirmations, deletions, and plugin inputs
The \internal/ui/dialog\ package now includes dedicated UI components for common user interactions: \ShowConfirm\ and \ShowConfirmAck\ for simple and string-verification confirmations, \ShowDelete\ for resource deletion with propagation and force options, \ShowError\ for displaying error messages with a cow-themed animation, \ShowPluginInputs\ for collecting structured plugin arguments (strings, numbers, booleans, dropdowns), \ShowPrompt\ for asynchronous background actions, \ShowRestart\ for pod restarts with field manager configuration, \ShowSelection\ for choosing from a list, and \ShowUploads\ for file transfers with retry and container selection. Unit tests have been added for the confirm, delete, error, and prompt dialogs.
internal/ui/dialog · high confidence
New model layer for cluster info, command input, and resource views
The internal model package has been restructured with new files that define the core data models and logic for the application. This includes \cluster.go\ and \cluster\_info.go\ for managing cluster metadata, version checks, and metrics; \cmd\_buff.go\ and \fish\_buff.go\ for handling command-line input, filtering, and auto-suggestions; \describe.go\ and \log.go\ for rendering resource descriptions and live logs; and \history.go\ for command history navigation. These changes establish the foundational model components that drive the UI views.
internal/model · high confidence
New renderers for aliases, benchmarks, contexts, and custom columns
The internal render package introduces new view renderers for Aliases, Benchmarks, and Kubernetes contexts, alongside a new base struct and comprehensive support for custom column definitions and realization. Users can now view alias mappings, benchmark results, and cluster contexts in the UI, while the custom column system allows flexible, spec-driven column rendering for various resources.
internal/render · high confidence
New terminal charting components for metrics visualization
Added a new \internal/tchart\ package providing terminal-based UI primitives for displaying metrics, including a \SparkLine\ for time-series trends, a \Gauge\ for OK/Fault status with delta indicators, and a \DotMatrix\ for numeric dial rendering. These components support configurable series colors, legends, and focus states, enabling richer in-terminal observability views.
internal/tchart · high confidence
New xray renderers for Kubernetes resources
The xray view now supports rendering for Deployments, DaemonSets, StatefulSets, ReplicaSets, Pods, Services, Namespaces, ServiceAccounts, and Containers. This adds visual dependency trees and health status indicators (e.g., replica counts, missing references) for these resource types, allowing users to see how they connect to underlying pods, config maps, and secrets.
internal/xray · high confidence
Removals
Removal of Kubernetes resource management layer
The entire Kubernetes resource management implementation in the \resource/k8s\ package has been removed. This includes the deletion of the API connection layer (\api.go\), the metrics server integration (\metrics.go\), and all individual resource handlers for Kubernetes objects such as Deployments, Pods, Services, ConfigMaps, Secrets, and Custom Resource Definitions. Users will no longer be able to view, list, or manage these Kubernetes resources through this component.
resource/k8s · high confidence
Removal of legacy resource definitions and tests
The \resource\ package has removed a large set of legacy Kubernetes resource implementations and their corresponding unit tests. Specifically, the code for managing ConfigMaps, ClusterRoles, ClusterRoleBindings, Custom Resources, CronJobs, Deployments, DaemonSets, and other core resources (along with their test files) has been deleted. This cleanup removes the internal logic for listing, displaying, and marshaling these specific resource types from this location.
resource · high confidence
Removal of legacy terminal UI views
The entire legacy terminal UI implementation in the \views\ package has been removed. This includes the main application shell (\app.go\), resource and pod views, command handling, colorers, and all associated test files. Users will no longer have access to this specific terminal-based interface layer.
views · high confidence
Removed vendored Kubernetes apps API client code
The vendored Kubernetes client-go code for the apps API group (versions v1, v1beta1, and v1beta2) has been removed. This includes all generated client interfaces and implementations for managing ControllerRevisions, DaemonSets, Deployments, ReplicaSets, Scales, and StatefulSets. Applications relying on these vendored packages for direct Kubernetes API interaction will need to update their dependencies or import the client-go library directly.
vendor/k8s.io/client-go/kubernetes/typed/apps/v1, vendor/k8s.io/client-go/kubernetes/typed/apps/v1beta1, vendor/k8s.io/client-go/kubernetes/typed/apps/v1beta2 · high confidence
Architecture
Introduce DAO accessor registry and resource-specific handlers
The internal DAO layer now uses a centralized accessor registry to route resource requests to specialized handlers. This change adds a new \accessor.go\ file that maps Kubernetes GroupVersionResources (GVRs) to specific DAO implementations (e.g., \Pod\, \Deployment\, \CronJob\, \HelmChart\) and provides a fallback to a generic \Scaler\ accessor for unregistered types. It also introduces new DAO files for handling specific resources like \Alias\, \Benchmark\, \Dir\, \Container\, and \Context\, enabling more targeted operations such as listing aliases, managing benchmark files, browsing directories, and viewing container details with metrics. This refactoring separates concerns by allowing each resource type to implement its own \List\, \Get\, \Describe\, and other methods, improving maintainability and extensibility of the data access layer.
internal/dao · high confidence
Refactor internal UI architecture with new key-action and configuration systems
The internal UI layer has been restructured to improve modularity and maintainability. A new \KeyActions\ system in \action.go\ centralizes keyboard shortcut definitions and mappings, replacing ad-hoc key handling. The \App\ struct in \app.go\ now explicitly manages these actions and initializes core UI primitives like the prompt, menu, and logo. Configuration management is consolidated in \config.go\, which introduces a \Configurator\ struct and dedicated file watchers for skins, custom views, and custom jumps, enabling real-time UI updates when configuration files change. Supporting components such as breadcrumbs (\crumbs.go\), status indicators (\indicator.go\), and delta calculations (\deltas.go\) have been introduced or refactored to integrate with this new structure, while extensive test coverage (\\*\_test.go\) has been added to validate the new behavior.
internal/ui · high confidence
Behavioural changes
Introduce per-context configuration storage with namespace favorite limits
K9s now stores configuration data per Kubernetes context in the \internal/config/data\ package, allowing settings like skins, read-only modes, and views to be maintained independently for each cluster context. The namespace configuration enforces a hard limit of 9 favorite namespaces, automatically trimming any excess entries during merge or validation operations. Additionally, the system now supports context-level proxy configuration and a NodeShell feature gate, with file paths sanitized to handle special characters in cluster names (such as AWS EKS ARNs).
internal/config/data · high confidence
Introduces new internal client package with optimized context switching and metrics handling
The \internal/client\ package has been introduced to centralize Kubernetes API interactions, featuring a new \SwitchContext\ method that pre-warms dynamic and connectivity clients to reduce redundant API calls during context changes. The client now defaults to a higher QPS (50) and burst (100) for improved performance, paginates metrics API calls to prevent timeouts on large clusters, and respects the \KUBECACHEDIR\ environment variable for configuration caching. It also includes robust handling for missing metrics servers and validates namespace access efficiently.
internal/client · high confidence
K9s configuration system refactored to XDG Base Directory Specification
The internal configuration system has been restructured to adhere to the XDG Base Directory Specification, moving configuration, state, and data files out of the user's home directory to prevent pollution. This change introduces new file paths for aliases, hotkeys, skins, and screen dumps, and adds support for context-specific configuration files. Additionally, the configuration now includes dedicated modules for managing aliases, benchmarks, and color inversion logic using Oklch color space, along with comprehensive validation schemas for all configuration types.
internal/config · high confidence
K9s rebrands to derailed, upgrades to Go 1.27, and modernizes build tooling
The project has officially rebranded from k8sland to derailed, updating the Go module path, Docker registry, and Homebrew tap to reflect the new identity. The build environment has been upgraded to Go 1.27.1 and Alpine 3.24, with the Dockerfile and CI pipelines adjusted accordingly. Build and release workflows have been modernized by migrating to GoReleaser v2, enabling multi-architecture builds (including arm64, ppc64le, and s390x), and adding support for native package formats like deb, rpm, and apk. Additionally, the application now uses klog for logging instead of logrus, allowing users to customize the log file path via the --logFile flag.
(repo-wide) · high confidence
New command-line argument parser and interpreter
The command-line interface now uses a dedicated \Interpreter\ and \args\ parser in \internal/view/cmd\ to handle user input. This change introduces support for fuzzy filtering (\-f\), label selectors (using \=\, \==\, \!=\), and Kubernetes context switching (\@\). It also adds tab-completion suggestions for namespaces and contexts, and ensures that the \dir\ command correctly handles absolute paths.
internal/view/cmd · high confidence
New internal port-forwarding model with annotation-based configuration
The \internal/port\ package has been replaced with a new implementation that manages port forwards via Kubernetes annotations (\k9scli.io/port-forwards\ and \k9scli.io/auto-port-forwards\). This change introduces structured types for container port specifications (\ContainerPortSpec\) and port-forward annotations (\PFAnn\), allowing users to define precise local-to-container port mappings using a specific string format (e.g., \container::localPort:containerPort\). The new logic handles parsing these annotations, matching them against exposed container ports, validating host port availability, and generating the necessary tunnel configurations for port forwarding.
internal/port · high confidence
Removed vendored Kubernetes API types
The vendored copies of the Kubernetes \k8s.io/api/apps/v1\ and \k8s.io/api/apps/v1beta1\ API packages have been removed from the repository. This deletion includes all associated generated code, type definitions, and protobuf files for core workload resources such as Deployments, DaemonSets, StatefulSets, and ReplicaSets, indicating a shift away from bundling these dependencies directly within the vendor directory.
(repo-wide) · high confidence
Test coverage
Added test fixtures for Kubernetes resources and benchmarking; Added test helpers for K9s configuration and Kubernetes client mocking.
Dependencies
Major dependency overhaul and module migration
The project has migrated its Go module path from github.com/k8sland/k9s to github.com/derailed/k9s and upgraded the Go version requirement to 1.26. This change includes a comprehensive update of dependencies, notably upgrading Kubernetes libraries (api, client-go, kubectl, etc.) to v0.37.0, Helm to v3.22.0, and the UI framework to github.com/derailed/tview v0.8.5. Additionally, the vendored copy of the old k8sland/tview has been removed, and several legacy dependencies such as google.golang.org/appengine and gopkg.in/yaml.v2 have been dropped in favor of modern alternatives like sigs.k8s.io/yaml and gopkg.in/yaml.v3.
(dependencies) · high confidence
Removed vendored Google Cloud and go-spew dependencies
The vendored copies of the \cloud.google.com/go\ (including \compute/metadata\) and \github.com/davecgh/go-spew\ packages have been removed from the repository. This eliminates the bundled source code, license files, and author/contributor metadata for these libraries, indicating a shift away from vendoring these specific dependencies.
vendor · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 69 → 68 (-0.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 66 → 66 (+0.0)
- Architecture 81 → 94 (+13.1)
- Maturity 64 → 60 (-3.1)
- Readiness 79 → 79 (-0.1)
- Security 79 → 80 (+1.2)
- Performance 83 → 95 (+12.0)
Resolved (25)
- Duplicated block (12 lines × 2) (internal/model/describe.go)
- Duplicated block (5 lines × 2) (internal/tchart/gauge.go)
- Duplicated block (8 lines × 6) (internal/dao/cronjob.go)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Medium CVE: GO-2026-6603 (go.mod)
- Near-duplicate member family (4 members, 18 shared lines) (internal/dao/dp.go)
- Near-duplicate member family (6 members, 15 shared lines) (internal/dao/cronjob.go)
- No ADRs found
- Off-boarding risk: anonymized user #1
- Orphaned file (internal/client/gvrs.go)
- Orphaned file (internal/dao/node.go)
- Orphaned file (internal/model/history.go)
- …and 5 more
New (126)
- Duplicated block (12 lines × 2) (internal/model/describe.go)
- Duplicated block (5 lines × 2) (internal/tchart/gauge.go)
- Edited copies of one member (3 members, 11+ corresponding lines) (internal/config/files.go)
- Edited copies of one member (3 members, 11+ corresponding lines) (internal/dao/dp.go)
- Edited copies of one member (3 members, 11+ corresponding lines) (internal/view/group.go)
- Edited copies of one member (3 members, 12+ corresponding lines) (internal/render/crb.go)
- Edited copies of one member (3 members, 12+ corresponding lines) (internal/view/app.go)
- Edited copies of one member (3 members, 13+ corresponding lines) (internal/model/describe.go)
- Edited copies of one member (3 members, 14+ corresponding lines) (internal/dao/rs.go)
- Edited copies of one member (3 members, 14+ corresponding lines) (internal/xray/dp.go)
- Edited copies of one member (3 members, 15+ corresponding lines) (internal/render/dp.go)
- Edited copies of one member (3 members, 17+ corresponding lines) (internal/view/container.go)
- Edited copies of one member (3 members, 17+ corresponding lines) (internal/view/dp.go)
- Edited copies of one member (3 members, 19+ corresponding lines) (internal/render/ro.go)
- Edited copies of one member (3 members, 21+ corresponding lines) (internal/view/pf_extender.go)
- Edited copies of one member (3 members, 22+ corresponding lines) (internal/view/details.go)
- Edited copies of one member (3 members, 25+ corresponding lines) (internal/render/dp.go)
- Edited copies of one member (3 members, 5+ corresponding lines) (internal/view/cow.go)
- Edited copies of one member (3 members, 9+ corresponding lines) (internal/model1/rows.go)
- Edited copies of one member (3 members, 9+ corresponding lines) (internal/view/details.go)
- …and 106 more
Changes since last survey
- 28 commits — 15 feature/other, 13 fixes
By area
- (root) — 8 commits
- internal/render — 5 commits
- internal/view — 4 commits
- .github/workflows — 3 commits
- .github/dependabot.yml — 2 commits
- internal/client — 2 commits
- internal/dao — 1 commit
- internal/model — 1 commit
- plugins/README.md — 1 commit
- plugins/kubectl-plugins — 1 commit
Notable commits
- fix: fix(client): report the K9s version in the Kubernetes User-Agent (#4300)
- fix: fix(client): use the core group for ReplicationControllers so they can be scaled (#4326)
- fix: fix(cmd): accept -l label flag in command line (#4360)
- fix: fix(cmd): keep the -f flag when a command line is rebuilt (#4356)
- fix: fix(custom_jump): Chain context functions instead of overwriting (#4359)
- fix: fix(docker): tag release images with both the version and latest (#4369)
- fix: fix(dp): flag a deployment whose pods were never created (#4332)
- fix: fix(model): keep the case of command and filter history (#4358)
- fix: fix(pdb): flag unhealthy PDBs for percent minAvailable and maxUnavailable (#4323)
- fix: fix(render): only read column attributes after the | separator (#4371)
- fix: fix(rs,job): flag a ReplicaSet with missing pods and stop flagging finished parallel jobs (#4334)
- fix: fix(stale): update stale issue and PR thresholds to 180 days for staleness and 30 days for closure (#4340)
- fix: fix(view): keep the dump dir's case when saving a table (#4346)
- change: chore(ci): ignore derailed/tcell in dependabot (#4365)
- change: chore(ci): pin actions to SHAs and add dependabot cooldown (#4363)
- change: chore(dependabot): group anchore go modules (#4331)
- change: chore(deps): bump alpine from 3.24.2 to 3.24.3 (#4351)
- change: chore(deps): bump github.com/anchore/grype from 0.120.1 to 0.121.0 (#4330)
- change: chore(deps): bump github.com/go-jose/go-jose/v4 from 4.1.5 to 4.1.6 (#4357)
- change: chore(deps): bump golang from 1.27.2-alpine3.24 to 1.27.3-alpine3.24 (#4350)
- …and 8 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
derailed/k9s was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 8d011cb21ab9a145220100898bce49f3c3571aa4 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-f3449e6eb431.