keyman-cli 0.1.1 → 0.2.1

package/README.md

@@ -6,7 +6,16 @@ Install the Rust-based Keyman CLI with npm:
 npm install -g keyman-cli
 ```
 
-Create a private `.yml` file with one mapping per project:
+Get started:
+
+```sh
+keyman init          # create ~/.keyman.yml with an example project and load it
+keyman edit          # add your projects and secrets
+cd ~/code/my-app
+keyman inject        # write .env for the project named after this folder
+```
+
+The master file maps project names to quoted string values:
 
 ```yaml
 my-app:
@@ -14,13 +23,19 @@ my-app:
   DEBUG: "true"
 ```
 
-Then run:
+More commands (leave out the project to use the current folder name):
 
 ```sh
-keyman load /path/to/master.yml
-keyman inject my-app /path/to/existing/project
+keyman load /path/to/master.yml   # use an existing master file
+keyman status                     # check every project
+keyman show my-app [--reveal]     # variable names, values masked by default
+keyman diff [--reveal]            # git-style diff of .env against the master file
+keyman save [--dry-run]           # save this folder's .env back to the master file
+eval "$(keyman export my-app)"    # load variables into a POSIX shell
+keyman run my-app -- npm start    # run a command with the variables, no .env file
+keyman completions bash           # also zsh, fish, powershell
 ```
 
-`load` remembers the master file path. `inject` replaces the project's `.env` file. Keep the master file private and ignore `.env` in Git.
+Run `keyman help <command>` for details. Keep the master file private and ignore `.env` in Git.
 
 Prebuilt binaries are included for Windows x64, macOS Intel and Apple Silicon, and Linux x64 and ARM64. No Rust installation is needed. On Windows systems that block the native executable, the command can use WSL if it is installed. The executable is available as both `keyman` and `keyman-cli`. [Source and full documentation](https://github.com/moonmangit/keyman-cli).

package/bin/keyman.cjs

@@ -53,9 +53,9 @@ function runWithWsl(args) {
   }
 
   const linuxArgs = [...args];
-  if (linuxArgs[0] === 'load' && linuxArgs.length === 2) {
+  if (['load', 'init'].includes(linuxArgs[0]) && linuxArgs.length === 2 && !linuxArgs[1].startsWith('-')) {
     linuxArgs[1] = toWslPath(linuxArgs[1]);
-  } else if (linuxArgs[0] === 'inject' && linuxArgs.length === 3) {
+  } else if (['inject', 'save', 'diff'].includes(linuxArgs[0]) && linuxArgs.length === 3 && !linuxArgs[2].startsWith('-')) {
     linuxArgs[2] = toWslPath(linuxArgs[2]);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyman-cli",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Manage project .env files from one private YAML file",
   "license": "MIT",
   "repository": {