Usage

binmate can be driven either through its interactive TUI or via individual CLI commands. This page covers everyday usage; see the interface for a tour of the TUI and the CLI reference for the full command list.

GitHub authentication recommended

Authenticating with GitHub avoids API rate limits and unlocks private repository access. See the authentication guide to set up a token or askpass script.

Interactive mode

Launch the TUI for interactive management by running binmate with no arguments:

binmate

This opens the Binary List View where you can browse, search, filter, and manage your binaries.

CLI commands

Add a binary

Add a binary from a GitHub release URL or from config:

# Add from URL
binmate add https://github.com/cli/cli/releases/download/v2.30.0/gh_2.30.0_linux_amd64.tar.gz

# Add from config
binmate add gh

List binaries

List all registered binaries:

binmate list

List versions of a specific binary:

binmate list gh

Install a binary

Install a specific version of a binary:

binmate install --binary gh --version v2.30.0

Install the latest version:

binmate install --binary gh --version latest

Switch versions

Switch to a different installed version:

binmate switch gh v2.29.0

Update to latest

Update a binary to the latest version:

binmate update gh

Remove a binary

Remove a binary from the database:

binmate remove gh

Remove a binary and its files:

binmate remove gh --files

View configuration

Display the current configuration:

binmate config

Display configuration as JSON:

binmate config --json

Sync configuration

Sync the configuration file with the database:

binmate sync

Version information

Show the current binmate version:

binmate --version
binmate version

Show detailed build metadata:

binmate version --verbose

Next steps

• Browse the full CLI reference.
• Learn how to configure binmate.