Aliases are a way of defining a shorthand reference to a WordPress install.

One or more aliases can be defined in config.yml or wp-cli.yml:

@wpdev:
  path: /srv/www/wordpress-develop.dev/src

An alias is called as the first argument to the wp executable:

salty-wordpress ➜  .wp-cli  wp @wpdev option get home
http://wordpress-develop.dev

The matching alias will overload the global parameters it defines. When an alias is used, any passed arguments will be treated as local parameters:

salty-wordpress ➜  .wp-cli  wp @wpdev option get home --path=/srv/www/wordpress-develop.dev/src
Error: Parameter errors:
 unknown --path parameter

This last implementation detail provides a path forward for solving #1222 without breaking backwards compat.

See #2039