diff --git a/README.md b/README.md
new file mode 100644
index 000000000..d5a11c7b4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# TMLIBS
+
+This repo is a home for various small packages.
+
+## autofile
+
+Autofile is file access with automatic log rotation. A group of files is maintained and rotation happens
+when the leading file gets too big. Provides a reader for reading from the file group.
+
+## cli
+
+CLI wraps the `cobra` and `viper` packages and handles some common elements of building a CLI like flags and env vars for the home directory and the logger.
+
+## clist
+
+Clist provides a linekd list that is safe for concurrent access by many readers.
+
+## common
+
+Common provides a hodgepodge of useful functions.
+
+## db
+
+DB provides a database interface and a number of implementions, including ones using an in-memory map, the filesystem directory structure,
+an implemention of LevelDB in Go, and the official LevelDB in C.
+
+## events
+
+Events is a synchronous PubSub package.
+
+## flowrate
+
+Flowrate is a fork of https://github.com/mxk/go-flowrate that added a `SetREMA` method.
+
+## log
+
+Log is a log package structured around key-value pairs that allows logging level to be set differently for different keys.
+
+## logger
+
+Logger is DEPRECATED. It's a simple wrapper around `log15`.
+
+## merkle
+
+Merkle provides a simple static merkle tree and corresponding proofs.
+
+## process
+
+Process is a simple utility for spawning OS processes.
+
+## pubsub
+
+PubSub is an asynchronous PubSub package.