diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000000..2b771c7a26
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "ghcide"]
+	path = ghcide
+	url = https://github.com/digital-asset/ghcide.git
diff --git a/README.md b/README.md
index a7977d09bc..e9ca4d775e 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,7 @@ Integration point for ghcide and haskell-ide-engine. One IDE to rule them all.
 
 This is *very* early stage software.
 
-To play along at home, it assumes the ghcide master is checked out at
-`../../digital-asset/ghcide` relative to this one.
+To play along at home, do a recursive `git clone`.
 
 Initial effort is to understand how plugins can be supported in a modular way.
 
diff --git a/cabal.project b/cabal.project
index fb13c7e1ed..619f019aa5 100644
--- a/cabal.project
+++ b/cabal.project
@@ -1,6 +1,6 @@
 packages:
          ./
-         ../../digital-asset/ghcide
+         ghcide
 
 tests: true
 
diff --git a/ghcide b/ghcide
new file mode 160000
index 0000000000..0992bc7326
--- /dev/null
+++ b/ghcide
@@ -0,0 +1 @@
+Subproject commit 0992bc73264fcb373255f3ec2ea08d7fe21e4847