Initial commit

Signed-off-by: Christian Dupuis <cd@atomist.com>

README.md

@@ -0,0 +1,65 @@
+**Note:** This repository is not an officially supported Docker project.  
+
+# `docker base` Docker CLI plugin
+
+Docker CLI plugin to detect base images of local or remote container images.
+
+![docker base detect](docs/screenshot.png "docker base detect")
+
+The `docker base detect` command shows the following data about detected base images:
+
+* Image name and tags
+* Image digest
+* Image vulnerabilities
+* Age of image
+* Link to the commit or Dockerfile from which the image was created
+* `Docker Official Image`, `Verified Publisher` or `Sponsored OSS` - if the image is trusted content; either from Docker Official Images, Verified Publishers or Sponsored OSS
+* `unsupported tag` - if the tag in use is not supported any longer (only for Docker Official Images)
+* `tag moved` - if the tag in use has moved in the meantime; a new image was pushed using the same tag 
+
+## Installation
+
+To install, run the following command in your terminal:
+
+```shell
+$ curl -sSfL https://raw.githubusercontent.com/docker/base-cli-plugin/main/install.sh | sh -s --
+```
+
+Alternatively, you can install manually by following these steps:
+
+* Download the plugin binary from the [release page](https://github.com/docker/base-cli-plugin/releases/latest)
+* Unzip the archive
+* Copy/move the binary into `$HOME/.docker/cli-plugins`
+
+## Usage
+
+### `docker base detect`
+
+To detect base images for local or remote images, use the following command:
+
+```shell
+$ docker base detect <image>
+```
+
+`<image>` can either be a local image id or fully qualified image name from a remote registry.
+
+### `docker base login`
+
+To authenticate with the Atomist data plane, use the following command:
+
+```shell
+$ docker base login --workspace <workspace id> --api-key <api key>
+```
+
+Authentication is not required. If not authenticated, the plugin will only use public data from Docker Official Images,
+Docker Verified Publishers or Docker-sponsored Open Source.
+
+Visit [dso.docker.com](https://dso.docker.com/r/auth/integrations) to obtain a `workspace id` and `api key`.
+
+### `docker base logout`
+
+To remove the authentication to the Atomist data plane, use the following command:
+
+```shell
+$ docker base logout
+```