diff --git a/pages/osx/shuf.md b/pages/osx/shuf.md
new file mode 100644
index 000000000..8452e60f3
--- /dev/null
+++ b/pages/osx/shuf.md
@@ -0,0 +1,19 @@
+# shuf
+
+> Generate random permutations.
+
+- Randomize the order of lines in a file and output the result:
+
+`shuf {{filename}}`
+
+- Only output the first 5 entries of the result:
+
+`shuf -n {{5}} {{filename}}`
+
+- Write output to another file:
+
+`shuf {{filename}} -o {{output_filename}}`
+
+- Generate random numbers in range 1-10:
+
+`shuf -i {{1-10}}`