diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3844dae
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+spc is stream.place chat, in the terminal. it listens to the jetstream for
+any chat records, and then compares the streamer field to the provided args.
+if there are no args, then it will display all chat messages.
+
+example:
+if i'm streaming on moth11.net, my did is `did:plc:25z6ogppprfvijcnqo2fsfce`
+so to view my chat, do `go run . did:plc:25z6ogppprfvijcnqo2fsfce`