diff --git a/README.rst b/README.rst
index cb0ee75..f9286b3 100644
--- a/README.rst
+++ b/README.rst
@@ -3,6 +3,19 @@ Python bindings to the Surveil API
 
 This is a client library for Surveil built on the Surveil API.
 
+Command-line API
+----------------
+
+Installing this package gets you a shell command, ``surveil``, that you
+can use to interact with the Surveil API.
+
+You'll need to provide the Surveil API URL. You can do this with the
+``--surveil-api-url`` parameter, but it's easier to just set it as environment
+variable::
+
+    export SURVEIL_API_URL=http://localhost:8080/v1
+
+You'll find complete documentation on the shell by running ``surveil help``.
 
 Python API
 ----------