diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..6b84afb
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+
+Provides Java bindings for various native APIs.
+
+* Get and set UNIX file mode.
+* Get PID of current process.
+* Determine if stdout/stderr are attached to a terminal.
+* Query the terminal size.
+
+Currently only ported to OS X.