update readme

1 files changed, 28 insertions, 1 deletions

diff --git a/README.md b/README.md
index 0312306..2bedb23 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,28 @@
-# A CLI tool for relying parties to manage their OpenID clients and provider configurations
+# Manage your re:claimID OpenID Connect clients
+
+This tools allows you to manage your OpenID Connect clients in re:claimID.
+
+## Installation
+This tool can be installed using rubygems:
+
+```
+$ gem install reclaim-oidc
+```
+
+## List clients
+To list all registered clients
+
+```
+$ reclaim-oidc --list
+```
+
+## Manage clients:
+Add a new client like this:
+```
+$ reclaim-oidc --add --client-name myclient --redirect-uri https://my.website.tld/authz_cb --description "My Cool Webpage"
+```
+
+Delete a client:
+```
+$ reclaim-oidc --delete --client-name myclient
+```