diff --git a/README.md b/README.md
new file mode 100644
index 0000000..33ca9f9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Shell Tools package
+
+This is a growing selection of shell tools used by me and my colleagues.
+
+Each tool is an individual program, which do often depend on other tools.
+Dependencies are best found by running the programs.
+
+To see the help page of each tool, run the ./README script
+
+## Installation
+
+`hg clone https://bitbucket.org/MoonQ/tools`
+`. tools/rc`
+
+It is best to add the second line, sourcing the rc file in your .bashrc