diff --git a/tools/toolbox/README.md b/tools/toolbox/README.md
new file mode 100644
index 000000000..056bb63e4
--- /dev/null
+++ b/tools/toolbox/README.md
@@ -0,0 +1,49 @@
+# Toolbox tools
+[Toolbox][toolbox] is a container tool for Linux, which allows the use of
+interactive command line environments for development, without having to
+install software on the host.
+
+It is suitable for gnome-shell development, and we maintain a number of scripts
+to make its use easier and more convenient.
+
+## create-toolbox.sh
+Create a new toolbox for gnome-shell development.
+
+The new toolbox uses a custom container image that includes all dependencies
+except [mutter]. Mutter is developed in lock-step with gnome-shell, and
+therefore needs to be updated more regularly than the image. The toolbox
+includes the `update-mutter` command that takes care of this, which is usually
+run by the script when creating the toolbox.
+
+When called with the `--builder` option, the script also sets up build
+configuration for the [GNOME Builder IDE][builder], which allows building
+and running gnome-shell from within the app.
+
+For other options, run the script with `--help`.
+
+## meson-build.sh
+Build and install a meson project in a toolbox.
+
+gnome-shell uses the [meson] build system, and doesn't require any build
+steps other than the standard meson commands. It is still convenient to
+have a single command to enter a toolbox and setup, compile and install
+the project.
+
+Run the script with `--help` to see available options.
+
+## run-gnome-shell.sh
+Run gnome-shell from a toolbox.
+
+The script can be used both from within a graphical session and from a TTY.
+It takes care of isolating the nested shell from the host session, and setting
+up the environment to allow apps to launch inside the nested instance.
+
+It also provides useful options for development, like running from `gdb`, or
+simulating multiple monitors or a greeter session.
+
+Run the script with `--help` to see all available options.
+
+[toolbox]: https://containertoolbx.org/
+[mutter]: https://gitlab.gnome.org/GNOME/mutter
+[builder]: https://apps.gnome.org/Builder/
+[meson]: https://mesonbuild.com