diff --git a/plugins/atom/README.md b/plugins/atom/README.md
new file mode 100644
index 000000000..75d77a0ac
--- /dev/null
+++ b/plugins/atom/README.md
@@ -0,0 +1,17 @@
+## atom
+
+Plugin for Atom, a cross platform text and code editor, available for Linux, Mac OS X, and Windows.
+
+### Requirements
+
+ * [Atom](https://atom.io/)
+
+### Usage
+
+ * If `at` command is called without an argument, launch Atom
+
+ * If `at` is passed a directory, `cd` to it and open it in Atom
+
+ * If `at` is passed a file, open it in Atom
+
+ * if `att` command is called, it is equivalent to `at .`, opening the current folder in Atom
diff --git a/plugins/vscode/README.md b/plugins/vscode/README.md
new file mode 100644
index 000000000..64216463f
--- /dev/null
+++ b/plugins/vscode/README.md
@@ -0,0 +1,17 @@
+## Visual Studio Code
+
+Plugin for Visual Studio Code, a text editor for Mac OS X, Windows, and Linux 
+
+### Requirements
+
+ * [Visual Studio Code](https://code.visualstudio.com)
+ 
+### Usage
+
+ * If the `code` command is called without an argument, launch VS Code
+
+ * If `code` is passed a directory, cd to it and open it in VS Code
+
+ * If `code` is passed a file, open it in VS Code
+
+*NOTE: `vscode` can be used as an alias in place of `code`*
\ No newline at end of file
diff --git a/plugins/vscode/vscode.plugin.zsh b/plugins/vscode/vscode.plugin.zsh
new file mode 100644
index 000000000..2dfd37948
--- /dev/null
+++ b/plugins/vscode/vscode.plugin.zsh
@@ -0,0 +1,17 @@
+alias vscode='code'
+
+#
+# If the code command is called without an argument, launch VS Code
+# If code is passed a directory, cd to it and open it in VS Code
+# If code is passed a file, open it in VS code
+#
+function code {
+    if [[ $# = 0 ]]
+    then
+        open -a "Visual Studio Code"
+    else
+        local argPath="$1"
+        [[ $1 = /* ]] && argPath="$1" || argPath="$PWD/${1#./}"
+        open -a "Visual Studio Code" "$argPath"
+    fi
+}