diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7de986c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# dirf
+
+it's a work in progress of a linux tool that would help comparing and syncing two directories.
+
+planned features will be:
+- going through all the files and directories in a directory and asking the user what to do with that directory:
+  - copy the file / all the directory in the target directory
+  - ignore the file / directory
+  - going inside this directory to select more precisely what files / directories you want to copy (recursivity)
+  - optionally remembering your choice
+- an optional GUI?