arshadkazmi42/squash


Squash your commands and give it a name tada tada

License: Unlicense

Language: JavaScript

Keywords: alias, bash-comm, cli, commands, linux, mac, name, name-commands, shell-command, squash


Squash 🎉

Build NPM Downloads Package Size NPM Version Contributors Commit Node Version

Squash

Let's squash your commands.

Squash allows you to give a custom name to your shell commands. These commands can be run using the custom name.

Give us a ⭐️ if you like our work ❤️

Buy Me A Coffee Become a Patron!

Please consider donating, if you like my work

Install

$ npm i -g ak-squash

Setup

  • Export the squash path, to make the commands executable.

    export PATH=$PATH:/usr/local/.squash

    To make this export permanent read here

  • Now try running squash --help. This should display details on using squash

  • This completes your setup

Usage

Once you are done with the setup. You can start giving custom names to your commands.

You can find example usage of all the available features of squash here

Syntax for using squash is

squash {{COMMAND}} --alias={{NAME_FOR_COMMAND}}

  • COMMAND: The shell command which will be given a name
  • NAME_FOR_COMMAND: The custom name

Note: You can wrap the command between "COMMAND" if the command contains any types of quotes or spaces

Example

$ squash ls /home/squash --alias=list_squash

Now for using above created command just run

$ list_squash

Available Flags

Flags that require parameters

squash {{COMMAND}} --{{FLAG}}={{NAME_FOR_COMMAND}}
  • alias: to give name to a command
  • rm: removes a previously squashed command

Flags without parameters

squash --{{FLAG}}
  • help: gets help for squash
  • list: lists all the created commands
  • system-alias: lists all the system reserved aliases
  • pass-args: arguments called on the alias will be passed to the command. Use when creating the alias

Limitations

  • It does not work in Windows.
  • It does not support the cd command
  • Manually exporting the path /usr/local/.squash is very important.

Contributing

We are constantly working on improving squash and we need all the help we can get. You can contribute to this project by giving suggestions, fixing open issues or by implementing a new feature. Read our contibution guide here

Contributors

Thank you to all the contributors who help in making this project better 🙌

Project Statistics

Sourcerank 4
Repository Size 586 KB
Stars 11
Forks 9
Watchers 6
Open issues 8
Dependencies 287
Contributors 12
Tags 0
Created
Last updated
Last pushed

Top Contributors See all

Arshad Kazmi ArthurCueio Andrew Xue Sidak Singh Aulakh samuelweekes alexmarginean16 ConSou fathurifki Aneal Sharma Muzammil Konstantin Gorbunov newt#1234

Packages Referencing this Repo

ak-squash
Creating local alias for commands
Latest release 1.2.3 - Updated - 11 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-04-21 12:18:41 UTC

Login to resync this repository