Package Exports

as-known-as

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (as-known-as) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AKA

Alias Bash Command on Steroids

A Bash alias is essentially nothing more than a keyboard shortcut, an abbreviation, a means of avoiding typing a long command sequence.
It's because of these reasons that AKA provides a better alternative to the good ol' alias command:

Aliases are stored as files on your file system and hence can be easily shared and synchronized between your computers
AKA is cross-platform, which means it can be be used on your Linux, MacOS or Windows OS based machines
It comes with some advance & handy features, such as: search, dynamic parameters and more

Installation

npm install -g as-known-as

Usage

Usage: aka [options] [command]

Commands

<alias>=<command> [options] add a new alias or update existing one
move|mv [options] <from> <to> rename an existing alias and/or update its description
remove|rm [options] [alias...] remove a one or more aliases
list|ls [options] [filter] show all aliases with optional filter
execute|x <alias> execute an alias

Options

-h, --help output usage information
-V, --version output the version number
-C, --chdir <path> change the working directory

Cues

<...> - mandatory value
[...] - optional value

Examples

aka my-ip="curl http://ifconfig.me/ip" -d "get my public ip address" - adds a new my-ip alias with description. Description & command should be surrounded with quotes
aka ls ip - searches for all aliases which contains ip in either alias or description
aka x my-ip - execute my-ip alias (you can also omit the x if no options specified)
aka rm -rf - removes all aliases
aka --chdir /Users/nir/Dropbox/aka - changes AKA aliases directory

Advanced Usage

Dynamic command parameters - Use command option -p to leave out parameters which you want to add dynamically, for example:
aka ls="ls -la" -d "display folder content as a list" and then use as follows:
aka x ls -p "some-path"
Dynamic command parameters binding - Use command option -b to flag a command with bind-able parameters.
Parameters binding makes it even easier to execute aliases, by providing help and even set of valid options, for example:
aka scale-image="convert {{Source image path?|input}} -resize {{Scale rate (in percents)?|input}} {{Scaled image path?|input}}" -d "scale an image proportionally" and then the use as follows:
aka x scale-image -b

Dynamic command parameters binding format: - {{description|type[|options]}} - description - short parameter description - type - can be either input for free text or list for predefined list of valid options - options - semicolon separated list of strings, required only if type is list

Tips & Tricks

Call any of the commands with -h parameter to see its help
Always use absolute paths (avoid shortcuts symbols such as ~, .. etc)
You do not have to remember command's exact alias. If no command found with the exact alias, similar options will be displayed
Change AKA aliases directory to Dropbox, Google Drive or any other online storage service, to share your aliases with all your workstations
If you get EACCES: permission denied error on first run, either run as sudo (only once), or change your global node_modules directory to a path you have write access to
If you get Permission denied (publickey) error while running ssh command, make sure your public key path is absolute (i.e. do not start path with tilde ~)