kedge Documentation
CLI Reference
Every kedge command — authentication, edges, kubeconfigs, SSH, MCP.
The kedge CLI is a kubectl plugin (when installed via krew, it’s kubectl kedge; the standalone binary just drops the kubectl prefix). All commands below use the kubectl kedge form.
Global flags
| Flag | Description |
|---|---|
--hub-url <url> | URL of the hub. Required for login. Saved in kubeconfig after the first login. |
--token <token> | Bearer token (used with --hub-url instead of OIDC). |
--insecure-skip-tls-verify | Skip TLS verification — only for self-signed dev hubs. |
--context <name> | Kubeconfig context to operate against. Defaults to kedge. |
-v / --verbose | Verbose output. |
Command summary
| Command | What it does |
|---|---|
login | Authenticate with the hub (OIDC browser flow or static token). |
whoami | Show who you’re logged in as. |
edge create <name> | Register a new edge in the hub. |
edge list | List all edges and their connection status. |
edge get <name> | Show details for a specific edge. |
edge join-command <name> | Print the agent install command with the join token. |
edge delete <name> | Remove an edge. |
kubeconfig edge <name> | Generate a kubeconfig that proxies kubectl through the hub. |
ssh <name> | Open an SSH session (or run a single command) on a server-mode edge. |
mcp url | Print the multi-cluster MCP endpoint for AI agents. |
agent run | Start the agent as a foreground process (used inside container images). |
agent join | Install the agent as a persistent service (systemd or k8s Deployment). |
dev create | Create a local dev environment (two kind clusters). |
dev delete | Tear down the dev environment. |
Pick a command from the sidebar for the full reference.