docs: update readme

README.md

@@ -5,3 +5,37 @@
 ▐█▄█▌  ██▐█▌  ▐█▄▪▐█  ▐███▌  ▐█•█▌  ▐█▌  ▐█▪·•    ▐█▌·
  ▀▀▀   ▀▀ █▪   ▀▀▀▀   ·▀▀▀   .▀  ▀  ▀▀▀  .▀       ▀▀▀
 ```
+
+_**Run npm scripts using shorthands**_
+
+Unscript lets you run npm scripts using shorthands generated from the names of scripts in your `package.json`. Unscript creates shorthands by combining the first letter of each word separated by a delimiter (`:` by default).
+
+For example:
+
+- `dev` would be shortened to `d`.
+- `build:dev` would be shortened to `bd`.
+- `lint:watch` would be shortened to `lw`.
+
+## Options
+
+| option              | default | description                                   |
+| ------------------- | ------- | --------------------------------------------- |
+| `-p`, `--path`      | `"."`   | Path to folder containing package.json.       |
+| `-d`, `--delimiter` | `":"`   | Character to separate words by.               |
+| `-a`, `--auto`      | `false` | Run the selected script without confirmation. |
+| `-s`, `--scripts`   | `false` | Display scripts in found package.json.        |
+
+## Usage
+
+Unscript can be run using npx:
+
+```bash
+npx unscript lw
+```
+
+to save time writing that out it is recommended to alias the command to a shorter name:
+
+```bash
+# .bashrc .zshrc ...etc
+alias un='npx unscript'
+```

src/index.ts

@@ -16,11 +16,11 @@ import prompts from "prompts";
 program
   .version(packageJson.version, "-v, --version")
   .description(packageJson.description)
-  .addArgument(new Argument("shorthand"))
+  .addArgument(new Argument("query"))
   .option("-p, --path <path>", "Path to folder containing package.json.", ".")
   .option("-d, --delimiter <delim>", "Character to separate words by.", ":")
   .option("-a, --auto", "Run the selected script without confirmation.", false)
-  .option("-s, --scripts", "Display scripts in found package.json", false)
+  .option("-s, --scripts", "Display scripts in found package.json.", false)
   .action(
     async (
       query: string,