diff --git a/README.md b/README.md
index 5a618357..5302d083 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,8 @@
 
 The cooperative cloud utility belt 🎩🐇
 
+`abra` is a command-line tool for managing your own [Co-op Cloud](https://cloud.autonomic.zone). It can provision new servers, create applications, deploy them, run backup and restore operations and a whole lot of other things. It is the go-to tool for day-to-day operations when managing a Co-op Cloud instance.
+
 ## Documentation
 
 > [docs.cloud.autonomic.zone](https://docs.cloud.autonomic.zone/)
@@ -16,3 +18,7 @@ The cooperative cloud utility belt 🎩🐇
 ```sh
 curl https://install.abra.autonomic.zone | bash
 ```
+
+## Hack
+
+It's written in Bash! Just open up the `abra` file and start hacking. Then you can run it in place with `./abra`. The command-line interface is generated via [docopt](http://docopt.org/). If you add arguments then you need to run `make docopt` ro regenerate the parser.