- Download the latest release from https://github.com/priyamkalra0/Ally/releases
- Run ally once or create an empty directory at
%APPDATA%/Ally
- Move the executable
ally.exe
to%APPDATA%/Ally
- Add
%APPDATA%/Ally
to PATH and restart your shell.
Without arguments, ally
prints a list of aliases in the reusable form ally <name> <value>
on standard output.
Otherwise, if <value>
is given, an alias is defined for <name>
and <value>
,
and if <value>
is not given, any existing alias corresponding to <name>
is removed.
Options:
-s, --search <query>
Display all aliases that contain <query>
-c, --clear
Clear all currently set aliases.
--version
Show version information
-?, -h, --help
Show help and usage information
Now the command say
will be equivalent to echo
.
You can test it by running say yes
.
This should print yes to the console just like echo yes
would.
Now the command alias
will be equivalent to ally
.
You can test it by running alias -h
.
Right now this only works with command prompt, there is probably a way to make it work with powershell, but I do not use it often enough to do it myself.
By default, all parameters given when calling aliases are forwaded to <value>
.
To disable parameter forwarding for a particular alias, append %!
at the end of <value>
when defining the alias.
Additionally, you may use a preceding !
to escape enviroment variables in aliases.
Ex. ally show-profile "echo !%USERPROFILE!%"
Now, the enviroment variable will be expanded each time the alias is called, not when it is defined.
Under the hood, Ally simply manages .cmd
files for each alias you define in it's %APPDATA%/Ally
data directory, which can then be directly invoked from command prompt.