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