diff --git a/README.md b/README.md
new file mode 100644
index 000000000..39f81e3f9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+Strawman protocol for lightning channels.
+
+The wire protocol is documented in [lightning.proto](lightning.proto)
+(a [protobuf](https://developers.google.com/protocol-buffers/)
+definition file).
+
+There are command line utilities to create and process various packets
+in [test-cli](test-cli/HOWTO-USE.md).
+
+This is very much a testbed and work in progress; expect All The
+Things to change, all the time.
+
+Cheers,
+
+Rusty.