diff --git a/themes/agnoster/README.md b/themes/agnoster/README.md
new file mode 100644
index 0000000..ab68e88
--- /dev/null
+++ b/themes/agnoster/README.md
@@ -0,0 +1,26 @@
+## agnoster
+
+A ZSH theme optimized for people who use:
+
+* Solarized
+* Git
+* Unicode-compatible fonts and terminals (I use iTerm2 + Menlo)
+
+For Mac users, I highly recommend iTerm 2 + Solarized Dark
+
+![agnoster theme](https://f.cloud.github.com/assets/1765209/255379/452c668e-8c0b-11e2-8a8e-d1d13e57d15f.png)
+
+
+#### Characteristics
+
+* If the previous command failed (✘)
+* User @ Hostname (if user is not DEFAULT_USER, which can then be set in your profile)
+* Git status
+* Branch (⭠) or detached head (➦)
+* Current branch / SHA1 in detached head state
+* Dirty working directory (±, color change)
+* Working directory
+* Elevated (root) privileges (⚡)
+
+
+Ported from https://gist.github.com/agnoster/3712874.