update docs

README.md

@@ -1,12 +1,10 @@
 # alpine-cli
 
 A minimal image for running Linux CLI utilities - shell scripts and similar.
-This is useful for both interactive purposes or as the basis for other utility
+This is useful for interactive purposes or as the basis for other utility
 images.
 
-
 ## Quickstart
-
 ```console
 $ docker run -ti --rm ghcr.io/jswank/alpine-cli
 ~ $ ^D
@@ -17,26 +15,33 @@ $ bin/cli
 exit
 ```
 
-
 ## More Info
 
-The image is based on *alpine:edge*, with a small amount of additional setup/installation done. See 
-the [Dockerfile](Dockerfile) and [ctx/](ctx) for the specifics. 
+The image is based on *alpine:3*, with a small amount of additional
+setup/installation done. See the [Dockerfile](Dockerfile) and [ctx/home](ctx)
+for the specifics. 
 
   - Some basic utilities are installed for interative and script-based shell usage
   - A user is created with sudo (`-u root`) access. 
   - A few personal preferences are enabled via dotfiles.
 
-A helper script, using [casey/just](https://github.com/casey/just') is in [bin/cli](bin/cli). 
-It can be used to quickly start an ephemeral (or persistent) container.
+A helper script, using [casey/just](https://github.com/casey/just') is in
+[bin/cli](bin/cli). It can be used to quickly start an ephemeral (or
+persistent) container.
 
 ```console
-$ bin/cli --list
+$ bin/cli help
+
 Available recipes:
-    clean   # remove the persistent image
-    default # run
-    persist # run (or attach to) a perisent container {{n}}
-    run     # run a temporary container based on {{image}}
+    clean              # Remove the persistent container
+    default            # Invoke the 'run' recipe
+    help recipe="help" # Display this listing. Detailed help is available with 'help recipe_name'.
+    persist            # Run (or attach to) a persistent container
+    pull               # Pull the latest version of the image
+    restart            # Remove a running container, and run the default recipe
+    run                # Run an ephemeral container.
+    save i=image       # Save the running container as a new image
+
 
 $ bin/cli
 ~ $ ^D
@@ -47,7 +52,7 @@ $ bin/cli persist
 ~ $ 
 exit
 
-$ podman cp foo.json cli:/home/cli
+$ podman cp foo.json cli:/home/cli  # copy a file to the persistent container
 
 $ bin/cli persist
 ~ $ ls
@@ -61,3 +66,6 @@ Bonus - the same script could be used to start other containers:
 $ bin/cli image=alpine:edge
 / # ^D
 ```
+
+## License
+MIT

bin/cli

@@ -33,7 +33,7 @@ persist:
     podman run -ti --userns=keep-id --name {{n}} {{image}}
   fi
 
-# Pull the latest version of the container
+# Pull the latest version of the image
 @pull:
   podman pull {{image}} >/dev/null 2>&1