diff --git a/README.md b/README.md
index a9a3c6a..13f0a42 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,21 @@
 
 A simple script for querying contacts from the command line.
 
-## [mutt](http://www.mutt.org/) integration
+Usage:
+
+```sh
+$ contacts query
+NAME	EMAIL
+query@example.com	First Last
+```
+
+## Installation
+
+```sh
+brew install keith/formulae/contacts-cli
+```
+
+### [mutt](http://www.mutt.org/) integration
 
 Somewhere in your `muttrc`:
 
@@ -10,3 +24,12 @@ Somewhere in your `muttrc`:
 set query_command="contacts '%s'"
 bind editor <Tab> complete-query
 ```
+
+##### Notes
+
+- This is a simplified replacement for the unmaintained
+  [contacts](http://www.gnufoo.org/contacts/contacts.html)
+- This is distributed as a compiled executable rather than a swift
+  script to help with swift compatibility during new releases.
+- If you have trouble running the script inside tmux see [this
+  issue](https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard/issues/43)