1diff --git a/plugins/textmate/README.md b/plugins/textmate/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..9fd342135f1141a7aabd590268308da2e14b3da4
4--- /dev/null
5+++ b/plugins/textmate/README.md
6@@ -0,0 +1,16 @@
7+# TextMate plugin
8+
9+The plugin adds a function for the [TextMate](https://macromates.com) editor.
10+
11+To use it, add `textmate` to the plugins array of your zshrc file:
12+```
13+plugins=(... textmate)
14+```
15+
16+## Function
17+
18+The `tm` function provides the following options:
19+
20+- No arguments: Run `mate` in the current directory.
21+- Argument that is a directory: Run `mate` in the given directory and cd to it.
22+- Other arguments: Pass all arguments to `mate`. This allows for easy opening of multiple files.