ahmetb/kubectx · error

unsupported option '%s'

Error message

unsupported option '%s'

What it means

Argument-validation error from parseArgs: the first argument starts with '-' (and is not the bare '-'), but matches none of the recognized options (--help, --version, --current, --unset, rename syntax, -d, --shell, --readonly). Treated as an unknown flag and rejected via UnsupportedOp.

Source

Thrown at cmd/kubectx/flags.go:100

		if v == "--help" || v == "-h" {
			return HelpOp{}
		}
		if v == "--version" || v == "-V" {
			return VersionOp{}
		}
		if v == "--current" || v == "-c" {
			return CurrentOp{}
		}
		if v == "--unset" || v == "-u" {
			return UnsetOp{}
		}

		if new, old, ok := parseRenameSyntax(v); ok {
			return RenameOp{New: new, Old: old}
		}

		if strings.HasPrefix(v, "-") && v != "-" {
			return UnsupportedOp{Err: fmt.Errorf("unsupported option '%s'", v)}
		}
		return SwitchOp{Target: argv[0]}
	}
	return UnsupportedOp{Err: fmt.Errorf("too many arguments")}
}

View on GitHub (pinned to 12ad6fb22e)

Solutions

1. Run `kubectx --help` to see supported flags
2. Correct the typo in the option name

When it happens

Trigger: Thrown at cmd/kubectx/flags.go:100 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ahmetb/kubectx@12ad6fb22e (2026-09-02). Data as JSON: /api/errors/50133bac0394f20b. Report an issue: GitHub.