diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d01d06d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Shell
+
+Простая коммандная оболочка
+
+## Расширения командами
+
+По-умолчанию (и если не переназначить) есть только одна команда - `exit`
+
+Однако можно сколь угодно создавать таких команд. Необходимо лишь унаследоваться от класса `AbstractCommand`
+и перед запуском зарегистрировать её.
+
+## Пример использования
+
+```
+#!java
+Shell shell = new Shell();
+shell.registerCommand(new HelloCommand());
+shell.start();
+```
+
+## Сборка
+
+`gradle jar`
\ No newline at end of file