diff --git a/.gitignore b/.gitignore
index b5562bfd..4c317ad7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,6 +5,7 @@
 
 tmp/
 dist/
+book/
 
 # Packages
 packaging/pypi/lefthook/__pycache__/
diff --git a/book.toml b/book.toml
new file mode 100644
index 00000000..470eba59
--- /dev/null
+++ b/book.toml
@@ -0,0 +1,12 @@
+[book]
+authors = ["Evil Martians"]
+language = "en"
+multilingual = false
+src = "docs/mdbook"
+title = "Lefthook"
+
+[output.html]
+no-section-label = true
+
+[output.html.fold]
+enable = true
diff --git a/docs/mdbook/SUMMARY.md b/docs/mdbook/SUMMARY.md
new file mode 100644
index 00000000..4199f2b8
--- /dev/null
+++ b/docs/mdbook/SUMMARY.md
@@ -0,0 +1,72 @@
+# Lefthook
+
+# User guide
+
+- [Installation](./install.md)
+  - [Ruby](./installation/ruby.md)
+  - [Node.js](./installation/node.md)
+  - [Go](./installation/go.md)
+  - [Python](./installation/python.md)
+  - [Swift](./installation/swift.md)
+  - [Scoop](./installation/scoop.md)
+  - [Homebrew](./installation/homebrew.md)
+  - [Winget](./installation/winget.md)
+  - [Snap](./installation/snap.md)
+  - [Debian-based distro](./installation/deb.md)
+  - [RPM-based distro](./installation/rpm.md)
+  - [Alpine](./installation/alpine.md)
+  - [Arch Linux](./installation/arch.md)
+  - [Manual](./installation/manual.md)
+- [Configuration](./configuration/README.md)
+  - [`assert_lefthook_installed`](./configuration/assert_lefthook_installed.md)
+  - [`colors`](./configuration/colors.md)
+  - [`no_tty`](./configuration/no_tty.md)
+  - [`extends`](./configuration/extends.md)
+  - [`min_version`](./configuration/min_version.md)
+  - [`output`](./configuration/output.md)
+  - [`skip_output`](./configuration/skip_output.md)
+  - [`source_dir`](./configuration/source_dir.md)
+  - [`source_dir_local`](./configuration/source_dir_local.md)
+  - [`rc`](./configuration/rc.md)
+  - [`remotes`](./configuration/remotes.md)
+    - [`git_url`](./configuration/git_url.md)
+    - [`ref`](./configuration/ref.md)
+    - [`refetch`](./configuration/refetch.md)
+    - [`refetch_frequency`](./configuration/refetch_frequency.md)
+    - [`configs`](./configuration/configs.md)
+  - [Git hook](./configuration/Hook.md)
+    - [`files` (global)](./configuration/files-global.md)
+    - [`parallel`](./configuration/parallel.md)
+    - [`piped`](./configuration/piped.md)
+    - [`follow`](./configuration/follow.md)
+    - [`exclude_tags`](./configuration/exclude_tags.md)
+    - [`skip`](./configuration/skip.md)
+    - [`only`](./configuration/only.md)
+    - [`commands`](./configuration/Commands.md)
+      - [`run`](./configuration/run.md)
+      - [`skip`](./configuration/skip.md)
+      - [`only`](./configuration/only.md)
+      - [`tags`](./configuration/tags.md)
+      - [`glob`](./configuration/glob.md)
+      - [`files`](./configuration/files.md)
+      - [`file_types`](./configuration/file_types.md)
+      - [`env`](./configuration/env.md)
+      - [`root`](./configuration/root.md)
+      - [`exclude`](./configuration/exclude.md)
+      - [`fail_text`](./configuration/fail_text.md)
+      - [`stage_fixed`](./configuration/stage_fixed.md)
+      - [`interactive`](./configuration/interactive.md)
+      - [`use_stdin`](./configuration/use_stdin.md)
+      - [`priority`](./configuration/priority.md)
+    - [`scripts`](./configuration/Scripts.md)
+      - [`runner`](./configuration/runner.md)
+      - [`skip`](./configuration/skip.md)
+      - [`only`](./configuration/only.md)
+      - [`tags`](./configuration/tags.md)
+      - [`env`](./configuration/env.md)
+      - [`fail_text`](./configuration/fail_text.md)
+      - [`stage_fixed`](./configuration/stage_fixed.md)
+      - [`interactive`](./configuration/interactive.md)
+      - [`use_stdin`](./configuration/use_stdin.md)
+      - [`priority`](./configuration/priority.md)
+- [Usage](./usage.md)
diff --git a/docs/mdbook/configuration/Commands.md b/docs/mdbook/configuration/Commands.md
new file mode 100644
index 00000000..ef4c216e
--- /dev/null
+++ b/docs/mdbook/configuration/Commands.md
@@ -0,0 +1,32 @@
+### `commands`
+
+Commands to be executed for the hook. Each command has a name and associated run [options](#command).
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      ... # command options
+```
+
+### Command options
+
+- [`run`](./run.md)
+- [`skip`](./skip.md)
+- [`only`](./only.md)
+- [`tags`](./tags.md)
+- [`glob`](./glob.md)
+- [`files`](./files.md)
+- [`file_types`](./file_types.md)
+- [`env`](./env.md)
+- [`root`](./root.md)
+- [`exclude`](./exclude.md)
+- [`fail_text`](./fail_text.md)
+- [`stage_fixed`](./stage_fixed.md)
+- [`interactive`](./interactive.md)
+- [`use_stdin`](./use_stdin.md)
+- [`priority`](./priority.md)
diff --git a/docs/mdbook/configuration/Hook.md b/docs/mdbook/configuration/Hook.md
new file mode 100644
index 00000000..2f640a7b
--- /dev/null
+++ b/docs/mdbook/configuration/Hook.md
@@ -0,0 +1,2 @@
+## Git hook
+
diff --git a/docs/mdbook/configuration/README.md b/docs/mdbook/configuration/README.md
new file mode 100644
index 00000000..c7095ea4
--- /dev/null
+++ b/docs/mdbook/configuration/README.md
@@ -0,0 +1,53 @@
+# Config options
+
+- [`assert_lefthook_installed`](./assert_lefthook_installed.md)
+- [`colors`](./colors.md)
+- [`no_tty`](./no_tty.md)
+- [`extends`](./extends.md)
+- [`min_version`](./min_version.md)
+- [`output`](./output.md)
+- [`skip_output`](./skip_output.md)
+- [`source_dir`](./source_dir.md)
+- [`source_dir_local`](./source_dir_local.md)
+- [`rc`](./rc.md)
+- [`remotes`](./remotes.md)
+  - [`git_url`](./git_url.md)
+  - [`ref`](./ref.md)
+  - [`refetch`](./refetch.md)
+  - [`refetch_frequency`](./refetch_frequency.md)
+  - [`configs`](./configs.md)
+- [Git hook](./Hook.md)
+  - [`files` (global)](./files-global.md)
+  - [`parallel`](./parallel.md)
+  - [`piped`](./piped.md)
+  - [`follow`](./follow.md)
+  - [`exclude_tags`](./exclude_tags.md)
+  - [`skip`](./skip.md)
+  - [`only`](./only.md)
+  - [`commands`](./Commands.md)
+    - [`run`](./run.md)
+    - [`skip`](./skip.md)
+    - [`only`](./only.md)
+    - [`tags`](./tags.md)
+    - [`glob`](./glob.md)
+    - [`files`](./files.md)
+    - [`file_types`](./file_types.md)
+    - [`env`](./env.md)
+    - [`root`](./root.md)
+    - [`exclude`](./exclude.md)
+    - [`fail_text`](./fail_text.md)
+    - [`stage_fixed`](./stage_fixed.md)
+    - [`interactive`](./interactive.md)
+    - [`use_stdin`](./use_stdin.md)
+    - [`priority`](./priority.md)
+  - [`scripts`](./Scripts.md)
+    - [`runner`](./runner.md)
+    - [`skip`](./skip.md)
+    - [`only`](./only.md)
+    - [`tags`](./tags.md)
+    - [`env`](./env.md)
+    - [`fail_text`](./fail_text.md)
+    - [`stage_fixed`](./stage_fixed.md)
+    - [`interactive`](./interactive.md)
+    - [`use_stdin`](./use_stdin.md)
+    - [`priority`](./priority.md)
diff --git a/docs/mdbook/configuration/Scripts.md b/docs/mdbook/configuration/Scripts.md
new file mode 100644
index 00000000..1e45a6ef
--- /dev/null
+++ b/docs/mdbook/configuration/Scripts.md
@@ -0,0 +1,58 @@
+## Scripts
+
+Scripts are stored under `<source_dir>/<hook-name>/` folder. These scripts are your own executables which are being run in the project root.
+
+To add a script for a `pre-commit` hook:
+
+1. Run `lefthook add -d pre-commit`
+1. Edit `.lefthook/pre-commit/my-script.sh`
+1. Add an entry to `lefthook.yml`
+   ```yml
+   # lefthook.yml
+
+   pre-commit:
+     scripts:
+       "my-script.sh":
+         runner: bash
+   ```
+
+**Example**
+
+Let's create a bash script to check commit templates `.lefthook/commit-msg/template_checker`:
+
+```bash
+INPUT_FILE=$1
+START_LINE=`head -n1 $INPUT_FILE`
+PATTERN="^(TICKET)-[[:digit:]]+: "
+if ! [[ "$START_LINE" =~ $PATTERN ]]; then
+  echo "Bad commit message, see example: TICKET-123: some text"
+  exit 1
+fi
+```
+
+Now we can ask lefthook to run our bash script by adding this code to
+`lefthook.yml` file:
+
+```yml
+# lefthook.yml
+
+commit-msg:
+  scripts:
+    "template_checker":
+      runner: bash
+```
+
+When you try to commit `git commit -m "bad commit text"` script `template_checker` will be executed. Since commit text doesn't match the described pattern the commit process will be interrupted.
+
+### Script options
+
+- [`runner`](./runner.md)
+- [`skip`](./skip.md)
+- [`only`](./only.md)
+- [`tags`](./tags.md)
+- [`env`](./env.md)
+- [`fail_text`](./fail_text.md)
+- [`stage_fixed`](./stage_fixed.md)
+- [`interactive`](./interactive.md)
+- [`use_stdin`](./use_stdin.md)
+- [`priority`](./priority.md)
diff --git a/docs/mdbook/configuration/assert_lefthook_installed.md b/docs/mdbook/configuration/assert_lefthook_installed.md
new file mode 100644
index 00000000..ace5a136
--- /dev/null
+++ b/docs/mdbook/configuration/assert_lefthook_installed.md
@@ -0,0 +1,5 @@
+# `assert_lefthook_installed`
+
+**Default: `false`**
+
+When set to `true`, fail (with exit status 1) if `lefthook` executable can't be found in $PATH, under node_modules/, as a Ruby gem, or other supported method. This makes sure git hook won't omit `lefthook` rules if `lefthook` ever was installed.
diff --git a/docs/mdbook/configuration/colors.md b/docs/mdbook/configuration/colors.md
new file mode 100644
index 00000000..204828b8
--- /dev/null
+++ b/docs/mdbook/configuration/colors.md
@@ -0,0 +1,29 @@
+### `colors`
+
+**Default: `auto`**
+
+Whether enable or disable colorful output of Lefthook. This option can be overwritten with `--colors` option. You can also provide your own color codes.
+
+**Example**
+
+Disable colors.
+
+```yml
+# lefthook.yml
+
+colors: false
+```
+
+Custom color codes. Can be hex or ANSI codes.
+
+```yml
+# lefthook.yml
+
+colors:
+  cyan: 14
+  gray: 244
+  green: '#32CD32'
+  red: '#FF1493'
+  yellow: '#F0E68C'
+```
+
diff --git a/docs/mdbook/configuration/configs.md b/docs/mdbook/configuration/configs.md
new file mode 100644
index 00000000..2b93172c
--- /dev/null
+++ b/docs/mdbook/configuration/configs.md
@@ -0,0 +1,40 @@
+### `configs`
+
+**Default:** `[lefthook.yml]`
+
+An optional array of config paths from remote's root.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: git@github.com:evilmartians/lefthook
+    ref: v1.0.0
+    configs:
+      - examples/ruby-linter.yml
+      - examples/test.yml
+```
+
+Example with multiple remotes merging multiple configurations.
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: git@github.com:org/lefthook-configs
+    ref: v1.0.0
+    configs:
+      - examples/ruby-linter.yml
+      - examples/test.yml
+  - git_url: https://github.com/org2/lefthook-configs
+    configs:
+      - lefthooks/pre_commit.yml
+      - lefthooks/post_merge.yml
+  - git_url: https://github.com/org3/lefthook-configs
+    ref: feature/new
+    configs:
+      - configs/pre-push.yml
+
+```
diff --git a/docs/mdbook/configuration/env.md b/docs/mdbook/configuration/env.md
new file mode 100644
index 00000000..3b1aa88b
--- /dev/null
+++ b/docs/mdbook/configuration/env.md
@@ -0,0 +1,43 @@
+### `env`
+
+You can specify some ENV variables for the command or script.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    test:
+      env:
+        RAILS_ENV: test
+      run: bundle exec rspec
+```
+
+#### Extending PATH
+
+If your hook is run by GUI program, and you use some PATH tweaks in your ~/.<shell>rc, you might see an error saying *executable not found*. In that case You can extend the **$PATH** variable with `lefthook-local.yml` configuration the following way.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    test:
+      run: yarn test
+```
+
+```yml
+# lefthook-local.yml
+
+pre-commit:
+  commands:
+    test:
+      env:
+        PATH: $PATH:/home/me/path/to/yarn
+```
+
+**Notes**
+
+This option is useful when using lefthook on different OSes or shells where ENV variables are set in different ways.
diff --git a/docs/mdbook/configuration/exclude.md b/docs/mdbook/configuration/exclude.md
new file mode 100644
index 00000000..ed714563
--- /dev/null
+++ b/docs/mdbook/configuration/exclude.md
@@ -0,0 +1,61 @@
+### `exclude`
+
+For the `exclude` option two variants are supported:
+
+- A list of globs to be excluded
+- A single regular expression (deprecated)
+
+
+> NOTE
+>
+> The regular expression is matched against full paths to files in the repo,
+> relative to the repo root, using `/` as the directory separator on all platforms.
+> File paths do not begin with the separator or any other prefix.
+
+**Example**
+
+Run Rubocop on staged files with `.rb` extension except for `application.rb`, `routes.rb`, `rails_helper.rb`, and all Ruby files in `config/initializers/`.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      glob: "*.rb"
+      exclude:
+        - config/routes.rb
+        - config/application.rb
+        - config/initializers/*.rb
+        - spec/rails_helper.rb
+      run: bundle exec rubocop --force-exclusion {staged_files}
+```
+
+The same example using a regular expression.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      glob: "*.rb"
+      exclude: '(^|/)(application|routes|rails_helper|initializers/\w+)\.rb$'
+      run: bundle exec rubocop --force-exclusion {staged_files}
+```
+
+**Notes**
+
+Be careful with the config file format's string quoting and escaping rules when writing regexps in it. For YAML, single quotes are often the simplest choice.
+
+If you've specified `exclude` but don't have a files template in [`run`](./run.md) option, lefthook will check `{staged_files}` for `pre-commit` hook and `{push_files}` for `pre-push` hook and apply filtering. If no files left, the command will be skipped.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      exclude: '(^|/)application\.rb$'
+      run: bundle exec rubocop # skipped if only application.rb was staged
+```
diff --git a/docs/mdbook/configuration/exclude_tags.md b/docs/mdbook/configuration/exclude_tags.md
new file mode 100644
index 00000000..671c639d
--- /dev/null
+++ b/docs/mdbook/configuration/exclude_tags.md
@@ -0,0 +1,56 @@
+### `exclude_tags`
+
+[Tags](./tags.md) or command names that you want to exclude. This option can be overwritten with `LEFTHOOK_EXCLUDE` env variable.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  exclude_tags: frontend
+  commands:
+    lint:
+      tags: frontend
+      ...
+    test:
+      tags: frontend
+      ...
+    check-syntax:
+      tags: documentation
+```
+
+```bash
+lefthook run pre-commit # will only run check-syntax command
+```
+
+**Notes**
+
+This option is good to specify in `lefthook-local.yml` when you want to skip some execution locally.
+
+```yml
+# lefthook.yml
+
+pre-push:
+  commands:
+    packages-audit:
+      tags:
+        - frontend
+        - security
+      run: yarn audit
+    gems-audit:
+      tags:
+        - backend
+        - security
+      run: bundle audit
+```
+
+You can skip commands by tags:
+
+```yml
+# lefthook-local.yml
+
+pre-push:
+  exclude_tags:
+    - frontend
+```
diff --git a/docs/mdbook/configuration/extends.md b/docs/mdbook/configuration/extends.md
new file mode 100644
index 00000000..9b66f4f3
--- /dev/null
+++ b/docs/mdbook/configuration/extends.md
@@ -0,0 +1,29 @@
+### `extends`
+
+You can extend your config with another one YAML file. Its content will be merged. Extends for `lefthook.yml`, `lefthook-local.yml`, and [`remotes`](./remotes.md) configs are handled separately, so you can have different extends in these files.
+
+You can use asterisk to make a glob.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+extends:
+  - /home/user/work/lefthook-extend.yml
+  - /home/user/work/lefthook-extend-2.yml
+  - lefthook-extends/file.yml
+  - ../extend.yml
+  - projects/*/specific-lefthook-config.yml
+```
+
+> The extends will be merged to the main configuration in your file. Here is the order of settings applied:
+>
+> - `lefthook.yml` – main config file
+> - `extends` – configs specified in [extends](./extends.md) option
+> - `remotes` – configs specified in [remotes](./remotes.md) option
+> - `lefthook-local.yml` – local config file
+>
+> So, `extends` override settings from `lefthook.yml`, `remotes` override `extends`, and `lefthook-local.yml` can override everything.
+
+
diff --git a/docs/mdbook/configuration/fail_text.md b/docs/mdbook/configuration/fail_text.md
new file mode 100644
index 00000000..3173762f
--- /dev/null
+++ b/docs/mdbook/configuration/fail_text.md
@@ -0,0 +1,27 @@
+### `fail_text`
+
+You can specify a text to show when the command or script fails.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: yarn lint
+      fail_text: Add node executable to $PATH
+```
+
+```bash
+$ git commit -m 'fix: Some bug'
+
+Lefthook v1.1.3
+RUNNING HOOK: pre-commit
+
+  EXECUTE > lint
+
+SUMMARY: (done in 0.01 seconds)
+🥊  lint: Add node executable to $PATH env
+```
diff --git a/docs/mdbook/configuration/file_types.md b/docs/mdbook/configuration/file_types.md
new file mode 100644
index 00000000..762987e9
--- /dev/null
+++ b/docs/mdbook/configuration/file_types.md
@@ -0,0 +1,59 @@
+### `file_types`
+
+Filter files in a [`run`](./run.md) templates by their type. Supported types:
+
+|File type| Exlanation|
+|---------|-----------|
+|`text`   | Any file that contains text. Symlinks are not followed. |
+|`binary` | Any file that contains non-text bytes. Symlinks are not followed. |
+|`executable` | Any file that has executable bits set. Symlinks are not followed. |
+|`not executable` | Any file without executable bits in file mode. Symlinks included. |
+|`symlink` | A symlink file. |
+|`not symlink` | Any non-symlink file. |
+
+> [!IMPORTANT]
+> When passed multiple file types all constraints will be applied to the resulting list of files.
+
+**Examples**
+
+Apply some different linters on text and binary files.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint-code:
+      run: yarn lint {staged_files}
+      file_types: text
+    check-hex-codes:
+      run: yarn check-hex {staged_files}
+      file_types: binary
+```
+
+Skip symlinks.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: yarn lint --fix {staged_files}
+      file_types:
+        - not symlink
+```
+
+Lint executable scripts.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: yarn lint --fix {staged_files}
+      file_types:
+        - executable
+        - text
+```
diff --git a/docs/mdbook/configuration/files-global.md b/docs/mdbook/configuration/files-global.md
new file mode 100644
index 00000000..edc60e19
--- /dev/null
+++ b/docs/mdbook/configuration/files-global.md
@@ -0,0 +1,16 @@
+### `files` (global)
+
+A custom git command for files to be referenced in `{files}` template. See [`run`](#run) and [`files`](#files).
+
+If the result of this command is empty, the execution of commands will be skipped.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  files: git diff --name-only master # custom list of files
+  commands:
+    ...
+```
diff --git a/docs/mdbook/configuration/files.md b/docs/mdbook/configuration/files.md
new file mode 100644
index 00000000..490b3763
--- /dev/null
+++ b/docs/mdbook/configuration/files.md
@@ -0,0 +1,39 @@
+### `files`
+
+A custom git command for files or directories to be referenced in `{files}` template for [`run`](./run.md) setting.
+
+If the result of this command is empty, the execution of commands will be skipped.
+
+This option overwrites the [hook-level `files`](./files-global.md) option.
+
+**Example**
+
+Provide a git command to list files.
+
+```yml
+# lefthook.yml
+
+pre-push:
+  commands:
+    stylelint:
+      tags:
+        - frontend
+        - style
+      files: git diff --name-only master
+      glob: "*.js"
+      run: yarn stylelint {files}
+```
+
+Call a custom script for listing files.
+
+```yml
+# lefthook.yml
+
+pre-push:
+  commands:
+    rubocop:
+      tags: backend
+      glob: "**/*.rb"
+      files: node ./lefthook-scripts/ls-files.js # you can call your own scripts
+      run: bundle exec rubocop --force-exclusion --parallel {files}
+```
diff --git a/docs/mdbook/configuration/follow.md b/docs/mdbook/configuration/follow.md
new file mode 100644
index 00000000..85338784
--- /dev/null
+++ b/docs/mdbook/configuration/follow.md
@@ -0,0 +1,23 @@
+### `follow`
+
+**Default: `false`**
+
+Follow the STDOUT of the running commands and scripts.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-push:
+  follow: true
+  commands:
+    backend-tests:
+      run: bundle exec rspec
+    frontend-tests:
+      run: yarn test
+```
+
+> NOTE
+>
+> If used with [`parallel`](#parallel) the output can be a mess, so please avoid setting both options to `true`.
diff --git a/docs/mdbook/configuration/git_url.md b/docs/mdbook/configuration/git_url.md
new file mode 100644
index 00000000..9a45b7b7
--- /dev/null
+++ b/docs/mdbook/configuration/git_url.md
@@ -0,0 +1,21 @@
+### `git_url`
+
+A URL to Git repository. It will be accessed with privileges of the machine lefthook runs on.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: git@github.com:evilmartians/lefthook
+```
+
+Or
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: https://github.com/evilmartians/lefthook
+```
diff --git a/docs/mdbook/configuration/glob.md b/docs/mdbook/configuration/glob.md
new file mode 100644
index 00000000..2e7a7004
--- /dev/null
+++ b/docs/mdbook/configuration/glob.md
@@ -0,0 +1,31 @@
+### `glob`
+
+You can set a glob to filter files for your command. This is only used if you use a file template in [`run`](./run.md) option or provide your custom [`files`](./files.md) command.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      glob: "*.{js,ts,jsx,tsx}"
+      run: yarn eslint {staged_files}
+```
+
+**Notes**
+
+For patterns that you can use see [this](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm) reference. We use [glob](https://github.com/gobwas/glob) library.
+
+If you've specified `glob` but don't have a files template in [`run`](./run.md) option, lefthook will check `{staged_files}` for `pre-commit` hook and `{push_files}` for `pre-push` hook and apply filtering. If no files left, the command will be skipped.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      glob: "*.js"
+      run: npm run lint # skipped if no .js files staged
+```
diff --git a/docs/mdbook/configuration/interactive.md b/docs/mdbook/configuration/interactive.md
new file mode 100644
index 00000000..de1e316c
--- /dev/null
+++ b/docs/mdbook/configuration/interactive.md
@@ -0,0 +1,13 @@
+### `interactive`
+
+**Default: `false`**
+
+> NOTE
+>
+> If you want to pass stdin to your command or script but don't need to get the input from CLI, use [`use_stdin`](./use_stdin.md) option instead.
+
+
+Whether to use interactive mode. This applies the certain behavior:
+- All `interactive` commands/scripts are executed after non-interactive. Exception: [`piped`](./piped.md) option is set to `true`.
+- When executing, lefthook tries to open /dev/tty (Linux/Unix only) and use it as stdin.
+- When [`no_tty`](./no_tty.md) option is set, `interactive` is ignored.
diff --git a/docs/mdbook/configuration/min_version.md b/docs/mdbook/configuration/min_version.md
new file mode 100644
index 00000000..8de390ce
--- /dev/null
+++ b/docs/mdbook/configuration/min_version.md
@@ -0,0 +1,11 @@
+### `min_version`
+
+If you want to specify a minimum version for lefthook binary (e.g. if you need some features older versions don't have) you can set this option.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+min_version: 1.1.3
+```
diff --git a/docs/mdbook/configuration/no_tty.md b/docs/mdbook/configuration/no_tty.md
new file mode 100644
index 00000000..470eb034
--- /dev/null
+++ b/docs/mdbook/configuration/no_tty.md
@@ -0,0 +1,13 @@
+### `no_tty`
+
+**Default: `false`**
+
+Whether hide spinner and other interactive things. This can be also controlled with `--no-tty` option for `lefthook run` command.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+no_tty: true
+```
diff --git a/docs/mdbook/configuration/only.md b/docs/mdbook/configuration/only.md
new file mode 100644
index 00000000..b833c7bd
--- /dev/null
+++ b/docs/mdbook/configuration/only.md
@@ -0,0 +1,42 @@
+### `only`
+
+You can force a command, script, or the whole hook to execute only in certain conditions. This option acts like the opposite of [`skip`](./skip.md). It accepts the same values but skips execution only if the condition is not satisfied.
+
+> NOTE
+>
+> `skip` option takes precedence over `only` option, so if you have conflicting conditions the execution will be skipped.
+
+**Example**
+
+Execute a hook only for `dev/*` branches.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  only:
+    - ref: dev/*
+  commands:
+    lint:
+      run: yarn lint
+    test:
+      run: yarn test
+```
+
+When rebasing execute quick linter but skip usual linter and tests.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      skip: rebase
+      run: yarn lint
+    test:
+      skip: rebase
+      run: yarn test
+    lint-on-rebase:
+      only: rebase
+      run: yarn lint-quickly
+```
diff --git a/docs/mdbook/configuration/output.md b/docs/mdbook/configuration/output.md
new file mode 100644
index 00000000..66967219
--- /dev/null
+++ b/docs/mdbook/configuration/output.md
@@ -0,0 +1,35 @@
+### `output`
+
+You can manage verbosity using the `output` config. You can specify what to print in your output by setting these values, which you need to have
+
+Possible values are `meta,summary,success,failure,execution,execution_out,execution_info,skips`.
+By default, all output values are enabled
+
+You can also disable all output with setting `output: false`. In this case only errors will be printed.
+
+This config quiets all outputs except for errors.
+
+`output` is enabled if there is no `skip_output` and `LEFTHOOK_QUIET`.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+output:
+  - meta           # Print lefthook version
+  - summary        # Print summary block (successful and failed steps)
+  - empty_summary  # Print summary heading when there are no steps to run
+  - success        # Print successful steps
+  - failure        # Print failed steps printing
+  - execution      # Print any execution logs (but prints if the execution failed)
+  - execution_out  # Print execution output (but still prints failed commands output)
+  - execution_info # Print `EXECUTE > ...` logging
+  - skips          # Print "skip" (i.e. no files matched)
+```
+
+You can also *extend* this list with an environment variable `LEFTHOOK_OUTPUT`:
+
+```bash
+LEFTHOOK_OUTPUT="meta,success,summary" lefthook run pre-commit
+```
diff --git a/docs/mdbook/configuration/parallel.md b/docs/mdbook/configuration/parallel.md
new file mode 100644
index 00000000..c549cb26
--- /dev/null
+++ b/docs/mdbook/configuration/parallel.md
@@ -0,0 +1,9 @@
+### `parallel`
+
+**Default: `false`**
+
+> NOTE
+>
+> Lefthook runs commands and scripts **sequentially** by default.
+
+Run commands and scripts concurrently.
diff --git a/docs/mdbook/configuration/piped.md b/docs/mdbook/configuration/piped.md
new file mode 100644
index 00000000..e660d7f3
--- /dev/null
+++ b/docs/mdbook/configuration/piped.md
@@ -0,0 +1,25 @@
+### `piped`
+
+**Default: `false`**
+
+> NOTE
+>
+> Lefthook will return an error if both `piped: true` and `parallel: true` are set.
+
+Stop running commands and scripts if one of them fail.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+database:
+  piped: true # Stop if one of the steps fail
+  commands:
+    1_create:
+      run: rake db:create
+    2_migrate:
+      run: rake db:migrate
+    3_seed:
+      run: rake db:seed
+```
diff --git a/docs/mdbook/configuration/priority.md b/docs/mdbook/configuration/priority.md
new file mode 100644
index 00000000..763d5ba5
--- /dev/null
+++ b/docs/mdbook/configuration/priority.md
@@ -0,0 +1,38 @@
+### `priority`
+
+**Default: `0`**
+
+> NOTE
+>
+> This option makes sense only when `parallel: false` or `piped: true` is set.
+>
+> Value `0` is considered an `+Infinity`, so commands or scripts with `priority: 0` or without this setting will be run at the very end.
+
+Set priority from 1 to +Infinity. This option can be used to configure the order of the sequential steps.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+post-checkout:
+  piped: true
+  commands:
+    db-create:
+      priority: 1
+      run: rails db:create
+    db-migrate:
+      priority: 2
+      run: rails db:migrate
+    db-seed:
+      priority: 3
+      run: rails db:seed
+
+  scripts:
+    "check-spelling.sh":
+      runner: bash
+      priority: 1
+    "check-grammar.rb":
+      runner: ruby
+      priority: 2
+```
diff --git a/docs/mdbook/configuration/rc.md b/docs/mdbook/configuration/rc.md
new file mode 100644
index 00000000..3d9c5c8f
--- /dev/null
+++ b/docs/mdbook/configuration/rc.md
@@ -0,0 +1,71 @@
+### `rc`
+
+Provide an [**rc**](https://www.baeldung.com/linux/rc-files) file, which is actually a simple `sh` script. Currently it can be used to set ENV variables that are not accessible from non-shell programs.
+
+**Example**
+
+Use cases:
+
+- You have a GUI program that runs git hooks (e.g., VSCode)
+- You reference executables that are accessible only from a tweaked $PATH environment variable (e.g., when using rbenv or nvm, fnm)
+- Or even if your GUI program cannot locate the `lefthook` executable :scream:
+- Or if you want to use ENV variables that control the executables behavior in `lefthook.yml`
+
+```bash
+# An npm executable which is managed by nvm
+$ which npm
+/home/user/.nvm/versions/node/v15.14.0/bin/npm
+```
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: npm run eslint {staged_files}
+```
+
+Provide a tweak to access `npm` executable the same way you do it in your ~/<shell>rc.
+
+```yml
+# lefthook-local.yml
+
+# You can choose whatever name you want.
+# You can share it between projects where you use lefthook.
+# Make sure the path is absolute.
+rc: ~/.lefthookrc
+```
+
+Or
+
+```yml
+# lefthook-local.yml
+
+# If the path contains spaces, you need to quote it.
+rc: '"${XDG_CONFIG_HOME:-$HOME/.config}/lefthookrc"'
+```
+
+In the rc file, export any new environment variables or modify existing ones.
+
+```bash
+# ~/.lefthookrc
+
+# An nvm way
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# An fnm way
+export FNM_DIR="$HOME/.fnm"
+[ -s "$FNM_DIR/fnm.sh" ] && \. "$FNM_DIR/fnm.sh"
+
+# Or maybe just
+PATH=$PATH:$HOME/.nvm/versions/node/v15.14.0/bin
+```
+
+```bash
+# Make sure you updated git hooks. This is important.
+$ lefthook install -f
+```
+
+Now any program that runs your hooks will have a tweaked PATH environment variable and will be able to get `nvm` :wink:
diff --git a/docs/mdbook/configuration/ref.md b/docs/mdbook/configuration/ref.md
new file mode 100644
index 00000000..b797a66b
--- /dev/null
+++ b/docs/mdbook/configuration/ref.md
@@ -0,0 +1,17 @@
+### `ref`
+
+An optional *branch* or *tag* name.
+
+> NOTE
+>
+> If you initially had `ref` option, ran `lefthook install`, and then removed it, lefthook won't decide which branch/tag to use as a ref. So, if you added it once, please, use it always to avoid issues in local setups.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: git@github.com:evilmartians/lefthook
+    ref: v1.0.0
+```
diff --git a/docs/mdbook/configuration/refetch.md b/docs/mdbook/configuration/refetch.md
new file mode 100644
index 00000000..cdf45d38
--- /dev/null
+++ b/docs/mdbook/configuration/refetch.md
@@ -0,0 +1,15 @@
+### `refetch`
+
+**Default:** `false`
+
+Force remote config refetching on every run. Lefthook will be refetching the specified remote every time it is called.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: https://github.com/evilmartians/lefthook
+    refetch: true
+```
diff --git a/docs/mdbook/configuration/refetch_frequency.md b/docs/mdbook/configuration/refetch_frequency.md
new file mode 100644
index 00000000..b6e10009
--- /dev/null
+++ b/docs/mdbook/configuration/refetch_frequency.md
@@ -0,0 +1,23 @@
+### `refetch_frequency`
+
+**Default:** Not set
+
+Specifies how frequently Lefthook should refetch the remote configuration. This can be set to `always`, `never` or a time duration like `24h`, `30m`, etc.
+
+- When set to `always`, Lefthook will always refetch the remote configuration on each run.
+- When set to a duration (e.g., `24h`), Lefthook will check the last fetch time and refetch the configuration only if the specified amount of time has passed.
+- When set to `never` or not set, Lefthook will not fetch from remote.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+remotes:
+  - git_url: https://github.com/evilmartians/lefthook
+    refetch_frequency: 24h # Refetches once every 24 hours
+```
+
+> WARNING
+> If `refetch` is set to `true`, it overrides any setting in `refetch_frequency`.
+
diff --git a/docs/mdbook/configuration/remotes.md b/docs/mdbook/configuration/remotes.md
new file mode 100644
index 00000000..fa902c60
--- /dev/null
+++ b/docs/mdbook/configuration/remotes.md
@@ -0,0 +1,20 @@
+## `remotes`
+
+> [!IMPORTANT]
+> :test_tube: This feature is in **Beta** version
+
+You can provide multiple remote configs if you want to share yours lefthook configurations across many projects. Lefthook will automatically download and merge configurations into your local `lefthook.yml`.
+
+You can use [`extends`](./extends.md) but the paths must be relative to the remote repository root.
+
+If you provide [`scripts`](./scripts.md) in a remote config file, the [scripts](./source_dir.md) folder must also be in the **root of the repository**.
+
+**Note**
+
+The configuration from `remotes` will be merged to the local config using the following priority:
+
+1. Local main config (`lefthook.yml`)
+1. Remote configs (`remotes`)
+1. Local overrides (`lefthook-local.yml`)
+
+This priority may be changed in the future. For convenience, if you use `remotes`, please don't configure any hooks.
diff --git a/docs/mdbook/configuration/root.md b/docs/mdbook/configuration/root.md
new file mode 100644
index 00000000..8d038e5f
--- /dev/null
+++ b/docs/mdbook/configuration/root.md
@@ -0,0 +1,35 @@
+### `root`
+
+You can change the CWD for the command you execute using `root` option.
+
+This is useful when you execute some `npm` or `yarn` command but the `package.json` is in another directory.
+
+For `pre-push` and `pre-commit` hooks and for the custom `files` command `root` option is used to filter file paths. If all files are filtered the command will be skipped.
+
+**Example**
+
+Format and stage files from a `client/` folder.
+
+```bash
+# Folders structure
+
+$ tree .
+.
+├── client/
+│   ├── package.json
+│   ├── node_modules/
+|   ├── ...
+├── server/
+|   ...
+```
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      root: "client/"
+      glob: "*.{js,ts}"
+      run: yarn eslint --fix {staged_files} && git add {staged_files}
+```
diff --git a/docs/mdbook/configuration/run.md b/docs/mdbook/configuration/run.md
new file mode 100644
index 00000000..1194d1e1
--- /dev/null
+++ b/docs/mdbook/configuration/run.md
@@ -0,0 +1,165 @@
+### `run`
+
+This is a mandatory option for a command. This is actually a command that is executed for the hook.
+
+You can use files templates that will be substituted with the appropriate files on execution:
+
+- `{files}` - custom [`files`](#files) command result.
+- `{staged_files}` - staged files which you try to commit.
+- `{push_files}` - files that are committed but not pushed.
+- `{all_files}` - all files tracked by git.
+- `{cmd}` - shorthand for the command from `lefthook.yml`.
+- `{0}` - shorthand for the single space-joint string of git hook arguments.
+- `{N}` - shorthand for the N-th git hook argument.
+
+**Example**
+
+Run `yarn lint` on `pre-commit` hook.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: yarn lint
+```
+
+#### `{files}` template
+
+Run `go vet` only on files listed with `git ls-files -m` command with `.go` extension.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    govet:
+      files: git ls-files -m
+      glob: "*.go"
+      run: go vet {files}
+```
+
+#### `{staged_files}` template
+
+Run `yarn eslint` only on staged files with `.js`, `.ts`, `.jsx`, and `.tsx` extensions.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    eslint:
+      glob: "*.{js,ts,jsx,tsx}"
+      run: yarn eslint {staged_files}
+```
+
+#### `{push_files}` template
+
+If you want to lint files only before pushing them.
+
+```yml
+# lefthook.yml
+
+pre-push:
+  commands:
+    eslint:
+      glob: "*.{js,ts,jsx,tsx}"
+      run: yarn eslint {push_files}
+```
+
+#### `{all_files}` template
+
+Simply run `bundle exec rubocop` on all files with `.rb` extension excluding `application.rb` and `routes.rb` files.
+
+> [!NOTE]
+>
+> `--force-exclusion` will apply `Exclude` configuration setting of Rubocop.
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    rubocop:
+      tags:
+        - backend
+        - style
+      glob: "*.rb"
+      exclude:
+        - config/application.rb
+        - config/routes.rb
+      run: bundle exec rubocop --force-exclusion {all_files}
+```
+
+#### `{cmd}` template
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: yarn lint
+  scripts:
+    "good_job.js":
+      runner: node
+```
+
+You can wrap it in docker runner locally:
+
+```yml
+# lefthook-local.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: docker run -it --rm <container_id_or_name> {cmd}
+  scripts:
+    "good_job.js":
+      runner: docker run -it --rm <container_id_or_name> {cmd}
+```
+
+#### Git arguments
+
+Make sure commits are signed.
+
+```yml
+# lefthook.yml
+
+# Note: commit-msg hook takes a single parameter,
+#       the name of the file that holds the proposed commit log message.
+# Source: https://git-scm.com/docs/githooks#_commit_msg
+commit-msg:
+  commands:
+    multiple-sign-off:
+      run: 'test $(grep -c "^Signed-off-by: " {1}) -lt 2'
+```
+
+**Notes**
+
+#### Rubocop
+
+If using `{all_files}` with RuboCop, it will ignore RuboCop's `Exclude` configuration setting. To avoid this, pass `--force-exclusion`.
+
+#### Quotes
+
+If you want to have all your files quoted with double quotes `"` or single quotes `'`, quote the appropriate shorthand:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      glob: "*.js"
+      # Quoting with double quotes `"` might be helpful for Windows users
+      run: yarn eslint "{staged_files}" # will run `yarn eslint "file1.js" "file2.js" "[strange name].js"`
+    test:
+      glob: "*.{spec.js}"
+      run: yarn test '{staged_files}' # will run `yarn eslint 'file1.spec.js' 'file2.spec.js' '[strange name].spec.js'`
+    format:
+      glob: "*.js"
+      # Will quote where needed with single quotes
+      run: yarn test {staged_files} # will run `yarn eslint file1.js file2.js '[strange name].spec.js'`
+```
diff --git a/docs/mdbook/configuration/runner.md b/docs/mdbook/configuration/runner.md
new file mode 100644
index 00000000..23b3245a
--- /dev/null
+++ b/docs/mdbook/configuration/runner.md
@@ -0,0 +1,16 @@
+### `runner`
+
+You should specify a runner for the script. This is a command that should execute a script file. It will be called the following way: `<runner> <path-to-script>` (e.g. `ruby .lefthook/pre-commit/lint.rb`).
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  scripts:
+    "lint.js":
+      runner: node
+    "check.go":
+      runner: go run
+```
diff --git a/docs/mdbook/configuration/skip.md b/docs/mdbook/configuration/skip.md
new file mode 100644
index 00000000..d10d6673
--- /dev/null
+++ b/docs/mdbook/configuration/skip.md
@@ -0,0 +1,129 @@
+### `skip`
+
+You can skip all or specific commands and scripts using `skip` option. You can also skip when merging, rebasing, or being on a specific branch. Globs are available for branches.
+
+Possible skip values:
+- `rebase` - when in rebase git state
+- `merge` - when in merge git state
+- `merge-commit` - when current HEAD commit is the merge commit
+- `ref: main` - when on a `main` branch
+- `run: test ${SKIP_ME} -eq 1` - when `test ${SKIP_ME} -eq 1` is successful (return code is 0)
+
+**Example**
+
+Always skipping a command:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      skip: true
+      run: yarn lint
+```
+
+Skipping on merging and rebasing:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      skip:
+        - merge
+        - rebase
+      run: yarn lint
+```
+
+Or
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      skip: merge
+      run: yarn lint
+```
+
+Skipping when your are on a merge commit:
+
+```yml
+# lefthook.yml
+
+pre-push:
+  commands:
+    lint:
+      skip: merge-commit
+      run: yarn lint
+```
+
+Skipping the whole hook on `main` branch:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  skip:
+    - ref: main
+  commands:
+    lint:
+      run: yarn lint
+    test:
+      run: yarn test
+```
+
+Skipping hook for all `dev/*` branches:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  skip:
+    - ref: dev/*
+  commands:
+    lint:
+      run: yarn lint
+    test:
+      run: yarn test
+```
+
+Skipping hook by running a command:
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  skip:
+    - run: test "${NO_HOOK}" -eq 1
+  commands:
+    lint:
+      run: yarn lint
+    test:
+      run: yarn test
+```
+
+> TIP
+>
+> Always skipping is useful when you have a `lefthook-local.yml` config and you don't want to run some commands locally. So you just overwrite the `skip` option for them to be `true`.
+>
+> ```yml
+> # lefthook.yml
+>
+> pre-commit:
+>   commands:
+>     lint:
+>       run: yarn lint
+> ```
+>
+> ```yml
+> # lefthook-local.yml
+>
+> pre-commit:
+>   commands:
+>     lint:
+>       skip: true
+> ```
diff --git a/docs/mdbook/configuration/skip_output.md b/docs/mdbook/configuration/skip_output.md
new file mode 100644
index 00000000..55f1d2fe
--- /dev/null
+++ b/docs/mdbook/configuration/skip_output.md
@@ -0,0 +1,36 @@
+### `skip_output`
+
+> [!IMPORTANT]
+> **DEPRECATED** This feature is deprecated and might be removed in future versions. Please, use `[output]` instead for managing verbosity.
+
+You can manage the verbosity using the `skip_output` config. You can set whether lefthook should print some parts of its output.
+
+Possible values are `meta,summary,success,failure,execution,execution_out,execution_info,skips`.
+
+You can also disable all output with setting `skip_output: true`. In this case only errors will be printed.
+
+This config quiets all outputs except for errors.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+skip_output:
+  - meta           # Skips lefthook version printing
+  - summary        # Skips summary block (successful and failed steps) printing
+  - empty_summary  # Skips summary heading when there are no steps to run
+  - success        # Skips successful steps printing
+  - failure        # Skips failed steps printing
+  - execution      # Skips printing any execution logs (but prints if the execution failed)
+  - execution_out  # Skips printing execution output (but still prints failed commands output)
+  - execution_info # Skips printing `EXECUTE > ...` logging
+  - skips          # Skips "skip" printing (i.e. no files matched)
+```
+
+You can also *extend* this list with an environment variable `LEFTHOOK_QUIET`:
+
+```bash
+LEFTHOOK_QUIET="meta,success,summary" lefthook run pre-commit
+```
+
diff --git a/docs/mdbook/configuration/source_dir.md b/docs/mdbook/configuration/source_dir.md
new file mode 100644
index 00000000..4c20fd60
--- /dev/null
+++ b/docs/mdbook/configuration/source_dir.md
@@ -0,0 +1,17 @@
+### `source_dir`
+
+**Default: `.lefthook/`**
+
+Change a directory for script files. Directory for script files contains folders with git hook names which contain script files.
+
+Example of directory tree:
+
+```
+.lefthook/
+├── pre-commit/
+│   ├── lint.sh
+│   └── test.py
+└── pre-push/
+    └── check-files.rb
+```
+
diff --git a/docs/mdbook/configuration/source_dir_local.md b/docs/mdbook/configuration/source_dir_local.md
new file mode 100644
index 00000000..415b1356
--- /dev/null
+++ b/docs/mdbook/configuration/source_dir_local.md
@@ -0,0 +1,8 @@
+### `source_dir_local`
+
+**Default: `.lefthook-local/`**
+
+Change a directory for *local* script files (not stored in VCS).
+
+This option is useful if you have a `lefthook-local.yml` config file and want to reference different scripts there.
+
diff --git a/docs/mdbook/configuration/stage_fixed.md b/docs/mdbook/configuration/stage_fixed.md
new file mode 100644
index 00000000..17ef7c38
--- /dev/null
+++ b/docs/mdbook/configuration/stage_fixed.md
@@ -0,0 +1,20 @@
+### `stage_fixed`
+
+**Default: `false`**
+
+> Used **only for `pre-commit`** hook. Is ignored for other hooks.
+
+When set to `true` lefthook will automatically call `git add` on files after running the command or script. For a command if [`files`](./files.md) option was specified, the specified command will be used to retrieve files for `git add`. For scripts and commands without [`files`](./files.md) option `{staged_files}` template will be used. All filters ([`glob`](./glob.md), [`exclude`](./exclude.md)) will be applied if specified.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      run: npm run lint --fix {staged_files}
+      stage_fixed: true
+```
+
diff --git a/docs/mdbook/configuration/tags.md b/docs/mdbook/configuration/tags.md
new file mode 100644
index 00000000..5d8c4212
--- /dev/null
+++ b/docs/mdbook/configuration/tags.md
@@ -0,0 +1,22 @@
+### `tags`
+
+You can specify tags for commands and scripts. This is useful for [excluding](./exclude_tags.md). You can specify more than one tag using comma.
+
+**Example**
+
+```yml
+# lefthook.yml
+
+pre-commit:
+  commands:
+    lint:
+      tags:
+        - frontend
+        - js
+      run: yarn lint
+    test:
+      tags:
+        - backend
+        - ruby
+      run: bundle exec rspec
+```
diff --git a/docs/mdbook/configuration/use_stdin.md b/docs/mdbook/configuration/use_stdin.md
new file mode 100644
index 00000000..17753d32
--- /dev/null
+++ b/docs/mdbook/configuration/use_stdin.md
@@ -0,0 +1,31 @@
+### `use_stdin`
+
+> NOTE
+>
+> With many commands or scripts having `use_stdin: true`, only one will receive the data. The others will have nothing. If you need to pass the data from stdin to every command or script, please, submit a [feature request](https://github.com/evilmartians/lefthook/issues/new?assignees=&labels=feature+request&projects=&template=feature_request.md).
+
+Pass the stdin from the OS to the command/script.
+
+**Example**
+
+Use this option for the `pre-push` hook when you have a script that does `while read ...`. Without this option lefthook will hang: lefthook uses [pseudo TTY](https://github.com/creack/pty) by default, and it doesn't close stdin when all data is read.
+
+```bash
+# .lefthook/pre-push/do-the-magic.sh
+
+remote="$1"
+url="$2"
+
+while read local_ref local_oid remote_ref remote_oid; do
+  # ...
+done
+```
+
+```yml
+# lefthook.yml
+pre-push:
+  scripts:
+    "do-the-magic.sh":
+      runner: bash
+      use_stdin: true
+```
diff --git a/docs/mdbook/file_name.md b/docs/mdbook/file_name.md
new file mode 100644
index 00000000..c4b88492
--- /dev/null
+++ b/docs/mdbook/file_name.md
@@ -0,0 +1,17 @@
+## Config file name
+
+Lefthook supports the following file names for the main config:
+
+- `lefthook.yml`
+- `.lefthook.yml`
+- `lefthook.yaml`
+- `.lefthook.yaml`
+- `lefthook.toml`
+- `.lefthook.toml`
+- `lefthook.json`
+- `.lefthook.json`
+
+If there are more than 1 file in the project, only one will be used, and you'll never know which one. So, please, use one format in a project.
+
+Lefthook also merges an extra config with the name `lefthook-local`. All supported formats can be applied to this `-local` config. If you name your main config with the leading dot, like `.lefthook.json`, the `-local` config also must be named with the leading dot: `.lefthook-local.json`.
+
diff --git a/docs/mdbook/install.md b/docs/mdbook/install.md
new file mode 100644
index 00000000..ff935837
--- /dev/null
+++ b/docs/mdbook/install.md
@@ -0,0 +1,20 @@
+# Install lefthook
+
+Choose your fighter:
+
+- [Ruby](./installation/ruby.md)
+- [Node.js](./installation/node.md)
+- [Go](./installation/go.md)
+- [Python](./installation/python.md)
+- [Swift](./installation/swift.md)
+- [Scoop](./installation/scoop.md)
+- [Homebrew](./installation/homebrew.md)
+- [Winget](./installation/winget.md)
+- [Snap](./installation/snap.md)
+- [Debian-based distro](./installation/deb.md)
+- [RPM-based distro](./installation/rpm.md)
+- [Alpine](./installation/alpine.md)
+- [Arch Linux](./installation/arch.md)
+- [Manual](./installation/manual.md)
+
+Have a question? – Start a [discussion](https://github.com/evilmartians/lefthook/discussions)
diff --git a/docs/mdbook/installation/alpine.md b/docs/mdbook/installation/alpine.md
new file mode 100644
index 00000000..d8ac9ca0
--- /dev/null
+++ b/docs/mdbook/installation/alpine.md
@@ -0,0 +1,11 @@
+## APK packages for Alpine
+
+```sh
+sudo apk add --no-cache bash curl
+curl -1sLf 'https://dl.cloudsmith.io/public/evilmartians/lefthook/setup.alpine.sh' | sudo -E bash
+sudo apk add lefthook
+```
+
+See all instructions: https://cloudsmith.io/~evilmartians/repos/lefthook/setup/#formats-alpine
+
+[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=flat-square)](https://cloudsmith.com "RPM package repository hosting is graciously provided by Cloudsmith")
diff --git a/docs/mdbook/installation/arch.md b/docs/mdbook/installation/arch.md
new file mode 100644
index 00000000..27aa4599
--- /dev/null
+++ b/docs/mdbook/installation/arch.md
@@ -0,0 +1,7 @@
+## AUR for Arch
+
+You can install lefthook [package](https://aur.archlinux.org/packages/lefthook) from AUR.
+
+```sh
+yay -S lefthook
+```
diff --git a/docs/mdbook/installation/deb.md b/docs/mdbook/installation/deb.md
new file mode 100644
index 00000000..bc781ab2
--- /dev/null
+++ b/docs/mdbook/installation/deb.md
@@ -0,0 +1,10 @@
+## APT packages for Debian/Ubuntu Linux
+
+```sh
+curl -1sLf 'https://dl.cloudsmith.io/public/evilmartians/lefthook/setup.deb.sh' | sudo -E bash
+sudo apt install lefthook
+```
+See all instructions: https://cloudsmith.io/~evilmartians/repos/lefthook/setup/#formats-deb
+
+[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=flat-square)](https://cloudsmith.com "Debian package repository hosting is graciously provided by Cloudsmith")
+
diff --git a/docs/mdbook/installation/go.md b/docs/mdbook/installation/go.md
new file mode 100644
index 00000000..47a37804
--- /dev/null
+++ b/docs/mdbook/installation/go.md
@@ -0,0 +1,5 @@
+## Go
+
+```bash
+go install github.com/evilmartians/lefthook@latest
+```
diff --git a/docs/mdbook/installation/homebrew.md b/docs/mdbook/installation/homebrew.md
new file mode 100644
index 00000000..dff5bc8d
--- /dev/null
+++ b/docs/mdbook/installation/homebrew.md
@@ -0,0 +1,5 @@
+## Homebrew for MacOS and Linux
+
+```bash
+brew install lefthook
+```
diff --git a/docs/mdbook/installation/manual.md b/docs/mdbook/installation/manual.md
new file mode 100644
index 00000000..656a97c1
--- /dev/null
+++ b/docs/mdbook/installation/manual.md
@@ -0,0 +1,6 @@
+## Manuall installation with prebuilt executable
+
+Or take it from [binaries](https://github.com/evilmartians/lefthook/releases) and install manually.
+
+1. Download the executable for your OS and Arch
+1. Put the executable under the $PATH (for unix systems)
diff --git a/docs/mdbook/installation/node.md b/docs/mdbook/installation/node.md
new file mode 100644
index 00000000..a17c482c
--- /dev/null
+++ b/docs/mdbook/installation/node.md
@@ -0,0 +1,30 @@
+## Node.js
+
+Lefthook is available on NPM in the following flavors:
+
+ 1. [lefthook](https://www.npmjs.com/package/lefthook) that will install the proper binary:
+
+    ```bash
+    npm install lefthook --save-dev
+    # or yarn:
+    yarn add -D lefthook
+    ```
+
+ 1. [@evilmartians/lefthook](https://www.npmjs.com/package/@evilmartians/lefthook) with pre-bundled binaries for all architectures:
+
+    ```bash
+    npm install @evilmartians/lefthook --save-dev
+    # or yarn:
+    yarn add -D @evilmartians/lefthook
+    ```
+
+ 1. [@evilmartians/lefthook-installer](https://www.npmjs.com/package/@evilmartians/lefthook-installer) that will fetch binary file on installation:
+
+    ```bash
+    npm install @evilmartians/lefthook-installer --save-dev
+    # or yarn:
+    yarn add -D @evilmartians/lefthook-installer
+    ```
+
+> NOTE
+> If you use `pnpm` package manager make sure you set `side-effects-cache = false` in your .npmrc, otherwise the postinstall script of the lefthook package won't be executed and hooks won't be installed.
diff --git a/docs/mdbook/installation/python.md b/docs/mdbook/installation/python.md
new file mode 100644
index 00000000..befca5e5
--- /dev/null
+++ b/docs/mdbook/installation/python.md
@@ -0,0 +1,5 @@
+## Python
+
+```sh
+python -m pip install --user lefthook
+```
diff --git a/docs/mdbook/installation/rpm.md b/docs/mdbook/installation/rpm.md
new file mode 100644
index 00000000..289aac28
--- /dev/null
+++ b/docs/mdbook/installation/rpm.md
@@ -0,0 +1,10 @@
+## RPM packages for CentOS/Fedora Linux
+
+```sh
+curl -1sLf 'https://dl.cloudsmith.io/public/evilmartians/lefthook/setup.rpm.sh' | sudo -E bash
+sudo yum install lefthook
+```
+
+See all instructions: https://cloudsmith.io/~evilmartians/repos/lefthook/setup/#repository-setup-yum
+
+[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith&style=flat-square)](https://cloudsmith.com "RPM package repository hosting is graciously provided by Cloudsmith")
diff --git a/docs/mdbook/installation/rpn.md b/docs/mdbook/installation/rpn.md
new file mode 100644
index 00000000..86cc6209
--- /dev/null
+++ b/docs/mdbook/installation/rpn.md
@@ -0,0 +1 @@
+# RPM-based distro
diff --git a/docs/mdbook/installation/ruby.md b/docs/mdbook/installation/ruby.md
new file mode 100644
index 00000000..b5414608
--- /dev/null
+++ b/docs/mdbook/installation/ruby.md
@@ -0,0 +1,9 @@
+## Ruby
+
+```bash
+gem install lefthook
+```
+
+**Troubleshooting**
+
+If you see the error `lefthook: command not found` you need to check your $PATH. Also try to restart your terminal.
diff --git a/docs/mdbook/installation/scoop.md b/docs/mdbook/installation/scoop.md
new file mode 100644
index 00000000..baca59a6
--- /dev/null
+++ b/docs/mdbook/installation/scoop.md
@@ -0,0 +1,5 @@
+## Scoop for Windows
+
+```sh
+scoop install lefthook
+```
diff --git a/docs/mdbook/installation/snap.md b/docs/mdbook/installation/snap.md
new file mode 100644
index 00000000..f05cda70
--- /dev/null
+++ b/docs/mdbook/installation/snap.md
@@ -0,0 +1,5 @@
+## Snap for Linux
+
+```sh
+snap install --classic lefthook
+```
diff --git a/docs/mdbook/installation/swift.md b/docs/mdbook/installation/swift.md
new file mode 100644
index 00000000..47ce4327
--- /dev/null
+++ b/docs/mdbook/installation/swift.md
@@ -0,0 +1,15 @@
+## Swift
+
+You can find the Swift wrapper plugin [here](https://github.com/csjones/lefthook-plugin).
+
+Utilize lefthook in your Swift project using Swift Package Manager:
+
+```swift
+.package(url: "https://github.com/csjones/lefthook-plugin.git", exact: "1.9.2"),
+```
+
+Or, with [mint](https://github.com/yonaskolb/Mint):
+
+```bash
+mint run csjones/lefthook-plugin
+```
diff --git a/docs/mdbook/installation/winget.md b/docs/mdbook/installation/winget.md
new file mode 100644
index 00000000..22b0a0ca
--- /dev/null
+++ b/docs/mdbook/installation/winget.md
@@ -0,0 +1,5 @@
+## Winget for Windows
+
+```sh
+winget install evilmartians.lefthook
+```
diff --git a/docs/mdbook/usage.md b/docs/mdbook/usage.md
new file mode 100644
index 00000000..8f04b05a
--- /dev/null
+++ b/docs/mdbook/usage.md
@@ -0,0 +1 @@
+# Usage