diff --git a/README.md b/README.md
index 43ca7b0..7873004 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,10 @@
 # radicle-native-ci
 
 This is an adapter for the [Radicle CI broker], for performing CI runs
-locally.
+locally. This means it reads a JSON message from its stdin, and writes
+two JSON messages to its stdout. Its configured via a configuration
+file specified in the `RADICLE_NATIVE_CI` environment variable. There
+is currently no logging.
 
 The CI run is performed locally, without any isolation. This is not
 safe and secure, but it's simple, and easy to get working. Do not use