From 45b466be259bc54f18b1df886380afa620a324fb Mon Sep 17 00:00:00 2001
From: Arity-T <tish.mainmail@gmail.com>
Date: Mon, 2 Feb 2026 22:21:41 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9F=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D1=8B=20?=
 =?UTF-8?q?=D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=8F=20git-filter-repo?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/git/git-filter-repo.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

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`.