but alias

Aliases allow you to create shortcuts for commonly used commands. They are stored in git config under the but.alias.* namespace.

Examples

List all configured aliases:

but alias

Create a new alias:

but alias add st status
but alias add stv "status --verbose"

Remove an alias:

but alias remove st

Usage: but alias <COMMAND>

Subcommands

but alias list

List all configured aliases (default)

Usage: but alias list

but alias add

Add a new alias

Creates a new alias that expands to the given command.

Examples

but alias add st status but alias add stv "status --verbose" but alias add co "commit --only"

Usage: but alias add <NAME> <VALUE> [OPTIONS]

Arguments:

• <NAME> — The name of the alias to create (required)
• <VALUE> — The command and arguments that the alias should expand to

If the value contains spaces or special characters, quote it: "status --verbose" (required)

Options:

• -g, --global — Store the alias globally (in ~/.gitconfig) instead of locally

but alias remove

Remove an existing alias

Examples

but alias remove st but alias remove co --global

Usage: but alias remove <NAME> [OPTIONS]

Arguments:

• <NAME> — The name of the alias to remove (required)

Options:

• -g, --global — Remove from global config (in ~/.gitconfig) instead of local