Проверяет staged diff
Команда custodes check смотрит только файлы, добавленные через git add, и ищет совпадения в новых строках.
stable release · v1.0.0
custodes
CLI-страж для Git-коммитов. Проверяет staged changes до коммита и останавливает API-ключи, токены, пароли и любые запрещённые строки из конфигурации.
- Git hookставится в pre-commit и проверяет индекс перед записью истории.
- .env rulesподдерживает собственный список banwords для проекта.
- Fast checkсканирует только добавленные в индекс изменения.
custodes check
$ git add config.py
$ custodes check
Commit blocked by Custodes.
Secret-like value found in staged diff.Минимальный сторож перед каждым коммитом
Custodes не пытается заменить полноценный audit pipeline. Он ловит очевидные секреты там, где цена ошибки самая низкая: до того, как изменения попали в историю.
Блокирует commit
При найденном секрете CLI завершает проверку с ошибкой, а pre-commit hook не дает коммиту пройти дальше.
Настраивается через .env
Можно задать banwords, включить ASCII-логотип и выбрать язык сообщений для локальной команды.
Рабочий процесс без лишней магии
Утилита держится рядом с Git и остается понятной: установил hook, добавил правила, проверил индекс.
Install
installer.sh готовит рабочую директорию и команду custodes в локальном окружении.
Init
custodes init добавляет pre-commit hook в текущий Git-репозиторий.
Check
custodes check запускает Python-сканер по staged files и правилам проекта.
Commit
Если секретов нет, Git продолжает коммит. Если есть, Custodes показывает причину остановки.
Первый стабильный релиз уже доступен
Custodes v1.0.0 готов к установке на Linux. Исходный код открыт, а обновления публикуются через GitHub Releases.
stable · v1.0.0
Custodes можно ставить и использовать
Релиз включает CLI, pre-commit hook, настраиваемые правила через .env, русскую и английскую локализацию,
а также команды обновления и удаления.
git clone https://github.com/No1se-pi/Custodes.git
cd Custodes
bash installer.sh
custodes init
Поддержка проекта
Помогите Custodes стать сильнее
Каждый перевод, star и полезный issue помогают выпускать новые проверки, улучшать документацию и делать защиту секретов надёжнее.