diff --git a/README.md b/README.md
index b9c12abea2ef31c3419881f4464924f2eefdfffc..d23744aac0fcab30ed790f98ab86989f2f33633c 100644
--- a/README.md
+++ b/README.md
@@ -23,10 +23,18 @@ Welcome to Zed, a lightning-fast, collaborative code editor that makes your drea
     git clone https://github.com/zed-industries/zed.dev
     ```
 
+* Initialize submodules
+
+    ```
+    git submodule update --init --recursive
+    ```
+
 * Set up a local `zed` database and seed it with some initial users:
 
+    Create a personal GitHub token to run `script/bootstrap` once successfully. Then delete that token.
+
     ```
-    script/bootstrap
+    GITHUB_TOKEN=<$token> script/bootstrap
     ```
 
 ### Testing against locally-running servers