diff --git a/README.md b/README.md
new file mode 100644
index 0000000..57223be
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Pomodoro Prompt
+
+"What'd you do?" and "What're you gonna do?" dialog prompts that both pre-fill with whatever you put in for the last of either prompt at the end and start of every pomodoro work session, respectively.
+
+## Installation
+
+```
+mkdir -p ~/Projects/agaric/
+git clone git@gitlab.com:agaric/pomodoroprompt.git
+cd pomodoroprompt
+pip3 install -r requirements.txt
+```
+
+## Usage
+
+```
+cd ~/Projects/agaric/pomodoroprompt/
+python3 pomodoroprompt.py
+```
+
+See the `logs/` folder for daily, one-pomodoro-at-a-time time logs.