diff --git a/os/src/server/terminal_crosslink/README b/os/src/server/terminal_crosslink/README
new file mode 100644
index 0000000000..99940f8468
--- /dev/null
+++ b/os/src/server/terminal_crosslink/README
@@ -0,0 +1,14 @@
+The 'terminal_crosslink' server allows exactly two clients to communicate with
+each other using the 'Terminal' interface. Data sent to the server gets stored
+in a buffer of 4096 bytes (one buffer per client). As long as the data to be
+written fits into the buffer, the 'write()' call returns immediately. If no
+more data fits into the buffer, the 'write()' call blocks until the other
+client has consumed some of the data from the buffer via the 'read()' call. The
+'read()' call never blocks. A signal receiver can be used to block until new
+data is ready for reading.
+
+Example
+-------
+
+An example run script 'terminal_crosslink.run' can be found in the 'os/run'
+directory.