diff --git a/docs/git/git-filter-repo.md b/docs/git/git-filter-repo.md
index fc30eb1..77ba5b3 100644
--- a/docs/git/git-filter-repo.md
+++ b/docs/git/git-filter-repo.md
@@ -10,6 +10,21 @@
 pip install git-filter-repo
 ```
 
+## Примеры использования
+
+Удалить ненужный файл из истории. Он также будет удален с диска, поэтому если файл ещё нужен, то стоит сделать копию.
+
+```sh
+git filter-repo --path .env --invert-paths
+```
+
+Заменить строчку с секретом.
+
+```sh
+git filter-repo --replace-text <(printf 'SECRET_API_KEY=supersecret123==>SECRET_API_KEY=REDACTED')
+```
+
+
 ## Замена метаданных коммитов
 
 `git-filter-repo` позволяет создать скрипт на `Python`, который будет вызван для всех коммитов репозитория. Доступ к данным коммита, с возможностю их редактирования, предоставляется через объект `commit`. Таким образом можно описать любую логику изменения метаданных коммитов на обычном `Python`.