diff --git a/README.asciidoc b/README.asciidoc
index 86ec9a7e..857cd9f4 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -104,6 +104,13 @@ a symbolic link to the $PREFIX/share/kak/rc directory.
 ln -s /usr/share/kak/rc ~/.config/kak/autoload
 ----------------------------------------------
 
+Homebrew (OSX)
+~~~~~~~~~~~~~~
+
+-----------------------------------------------------------------------------------------------
+brew install --HEAD https://raw.githubusercontent.com/mawww/kakoune/homebrew/contrib/kakoune.rb
+-----------------------------------------------------------------------------------------------
+
 Running
 -------
 
diff --git a/contrib/kakoune.rb b/contrib/kakoune.rb
new file mode 100644
index 00000000..3dfbbc48
--- /dev/null
+++ b/contrib/kakoune.rb
@@ -0,0 +1,14 @@
+require "formula"
+
+class Kakoune < Formula
+  homepage "https://github.com/mawww/kakoune"
+  head "https://github.com/mawww/kakoune.git"
+
+  depends_on 'boost'
+
+  def install
+    cd 'src' do
+      system "make", "install", "PREFIX=#{prefix}"
+    end
+  end
+end