diff --git a/README.md b/README.md
index 88d473c..b94a0d2 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,12 @@ conway's game of life. supports other life-like cellular automata rules, see [wi
 
 left click or click and drag to flip cells on, and right click to spawn a glider.
 
+### wireworld
+
+wireworld.
+
+left click to toggle conductors (wires) on and off. right click to spawn an electron head in a conductor. spacebar to toggle play/pause.
+
 ## colorbrewer
 
 this repo includes a lua interface to [the lovely and accessible ColorBrewer2 colorschemes based on the research of Dr. Cynthia Brewer](https://colorbrewer2.org), based on [the original ColorBrewer code](https://github.com/axismaps/colorbrewer/) and the implementation in [Chroma.js](https://github.com/gka/chroma.js/).
@@ -36,6 +42,8 @@ love life
 love life B36/S23
 # other options
 love life <rule> <grid-unit-width-px> <simulation-steps-per-frame>
+
+love wireworld
 ```
 
 if you have [nix](https://nixos.org), you can use the provided flake.nix to get a working environment for running the games, as well as support for hot reloading if you want to hack on them.