diff --git a/plugins/idea/README.md b/plugins/idea/README.md
new file mode 100644
index 000000000..68b964350
--- /dev/null
+++ b/plugins/idea/README.md
@@ -0,0 +1,13 @@
+## idea
+
+Quick open Intellij Idea project in bash for MAC OS X
+
+### Requirements
+
+ * Intellij Idea or Intellij Idea Community Edition
+
+### Usage
+
+ * `idea .`
+ * `idea ~/projects/demo`
+