Skip to content

CLI Commands

This document details all CLI commands available in CMDR.

Root Command

cmdr [flags] [command]

Global Flags

Flag Short Description
--config -c Path to config file (default: ~/.cmdr/config.yaml)
--help -h Help for cmdr

Command Management

cmdr command install

Install a new command version into CMDR.

cmdr command install -n <name> -v <version> -l <location> [-a]

Flags:

Flag Short Required Description
--name -n Yes Command name
--version -v Yes Version string
--location -l Yes URL or file path to the binary
--activate -a No Activate immediately after install

Source: cmd/command/install.go1

Example:

# Install kubectl 1.28.0 from URL
cmdr command install -n kubectl -v 1.28.0 -l https://dl.k8s.io/release/v1.28.0/bin/linux/amd64/kubectl

# Install and activate immediately
cmdr command install -n kubectl -v 1.28.0 -l /path/to/kubectl -a

cmdr command use

Activate a specific version of a command.

cmdr command use -n <name> -v <version>

Flags:

Flag Short Required Description
--name -n Yes Command name
--version -v Yes Version to activate

Source: cmd/command/use.go2

Example:

cmdr command use -n kubectl -v 1.28.0

cmdr command list

List installed command versions.

cmdr command list [-n <name>] [-v <version>] [-a]

Flags:

Flag Short Description
--name -n Filter by command name
--version -v Filter by version
--activate -a Show only activated commands

Source: cmd/command/list.go

Example:

# List all commands
cmdr command list

# List all versions of kubectl
cmdr command list -n kubectl

# List only activated commands
cmdr command list -a

cmdr command remove

Remove a command version.

cmdr command remove -n <name> -v <version>

Flags:

Flag Short Required Description
--name -n Yes Command name
--version -v Yes Version to remove

Source: cmd/command/remove.go

cmdr command unset

Deactivate a command (remove from shims).

cmdr command unset -n <name>

Source: cmd/command/unset.go

cmdr command define

Define a command without downloading (for local binaries).

cmdr command define -n <name> -v <version> -l <path> [-a]

Source: cmd/command/define.go

Configuration Management

cmdr config list

List all configuration values.

cmdr config list

Source: cmd/config/list.go

cmdr config get

Get a specific configuration value.

cmdr config get -k <key>

Source: cmd/config/get.go

cmdr config set

Set a configuration value.

cmdr config set -k <key> -v <value>

Source: cmd/config/set.go

Example:

# Set log level
cmdr config set -k log.level -v debug

# Set URL replacement for proxy
cmdr config set -k download.replace -v '{"match": "...", "template": "..."}'

System Commands

cmdr init

Initialize CMDR environment.

cmdr init

This command: 1. Creates directory structure (bin/, shims/, profile/) 2. Generates shell profile scripts 3. Registers CMDR itself as a managed command

Source: cmd/init.go

cmdr upgrade

Upgrade CMDR to the latest version.

cmdr upgrade [-r <release>] [-a <asset>]

Flags:

Flag Short Description
--release -r Specific release name (default: latest)
--asset -a Specific asset name

Source: cmd/upgrade.go

cmdr doctor

Diagnose CMDR installation issues.

cmdr doctor

Checks for: - Directory structure integrity - Database accessibility - Shell profile configuration - PATH configuration

Source: cmd/doctor.go

cmdr version

Display CMDR version information.

cmdr version

Source: cmd/version.go

Command Structure

cmdr
├── command
│   ├── define    # Define command from local path
│   ├── install   # Install command from URL/path
│   ├── list      # List installed commands
│   ├── remove    # Remove a command version
│   ├── unset     # Deactivate a command
│   └── use       # Activate a command version
├── config
│   ├── get       # Get config value
│   ├── list      # List all config
│   └── set       # Set config value
├── doctor        # Diagnose issues
├── init          # Initialize CMDR
├── upgrade       # Upgrade CMDR
└── version       # Show version

  1. Install command implementation in cmd/command/install.go L12-L37 ↩

  2. Use command implementation in cmd/command/use.go L12-L32 ↩