1. Manuals
  2. Tumbleweed
  3. glab
  4. glab-alias-set(1)

Scroll to navigation

glab(1) glab(1)

NAME

glab-alias-set - Set an alias for a longer command.

SYNOPSIS

glab alias set '' [flags]

DESCRIPTION

Declare a word as an alias for a longer command.

Your expansion might include arguments and flags. If your expansion includes positional placeholders such as '$1' or '$2', any extra arguments that follow the invocation of an alias are inserted appropriately.

Specify '--shell' in your alias to run it through 'sh', a shell converter. Shell conversion enables you to compose commands with "|" or redirect with ">", with these caveats:

  • Any extra arguments following the alias are not passed to the expanded expression arguments by default.
  • You must explicitly accept the arguments using '$1', '$2', and so on.
  • Use '$@' to accept all arguments.

For Windows users only:

  • On Windows, shell aliases are executed with 'sh' as installed by Git For Windows. If you installed Git in some other way in Windows, shell aliases might not work for you.
  • Always use quotation marks when defining a command, as in the examples.

OPTIONS

-s, --shell[=false] Declare an alias to be passed through a shell interpreter.

OPTIONS INHERITED FROM PARENT COMMANDS

--help[=false] Show help for this command.

EXAMPLE

$ glab alias set mrv 'mr view'
$ glab mrv -w 123
# glab mr view -w 123
$ glab alias set createissue 'glab create issue --title "$1"'
$ glab createissue "My Issue" --description "Something is broken."
# => glab create issue --title "My Issue" --description "Something is broken."
$ glab alias set --shell igrep 'glab issue list --assignee="$1" | grep $2'
$ glab igrep user foo
# glab issue list --assignee="user" | grep "foo"

SEE ALSO

glab-alias(1)

Nov 2024 Auto generated by spf13/cobra