diff --git a/README.md b/README.md
index e828dc09..7937055c 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,20 @@ for Debian in the `debian` directory, used by Lars to build packages
 for his own use.
 
 
+## Running from the source tree
+
+To run `cib` or `cibtool` from the source tree:
+
+~~~sh
+cargo run --bin cib -- --config config.yaml process-events
+cargo run --bin cibtool -- --db ci-broker.db event list
+~~~
+
+Note the `--` argument. It tells `cargo run` that all the arguments
+that follow are to be passed to the program being run, and not used by
+`cargo` itself.
+
+
 ## Running tests
 
 To run the test suite for the CI broker: