Troubleshooting

Решение проблем

custodes: command not found

Проверьте наличие исполняемого файла:

ls -l ~/.local/bin/custodes

Проверьте PATH:

echo "$PATH"

При необходимости добавьте каталог:

export PATH="$HOME/.local/bin:$PATH"

Не создаётся виртуальное окружение

На Debian, Ubuntu или Kali установите пакет python3-venv:

sudo apt install python3-venv

Затем повторите установку.

custodes init сообщает о существующем hook

Custodes не перезаписывает существующий .git/hooks/pre-commit, чтобы не уничтожить чужую автоматизацию.

Варианты:

1. сохраните резервную копию существующего hook;
2. вручную объедините его логику с вызовом custodes check;
3. используйте custodes check вручную без установки hook.

Не удаляйте существующий hook, пока не поймёте, для чего он нужен.

Custodes не замечает изменение

Проверьте, что файл добавлен в Git index:

git add <file>
git diff --cached

Custodes не анализирует изменения, которые ещё не были добавлены через git add.

Ложное срабатывание

Custodes использует простой поиск подстроки. Удалите или уточните соответствующий элемент в banwords, затем повторите проверку:

custodes config
custodes check

status или update не подключается к GitHub

Этим командам нужен интернет-доступ к GitHub. Проверьте сеть, DNS, прокси и доступность:

https://github.com/No1se-pi/Custodes

После uninstall Git не даёт выполнить коммит

Вероятно, в репозитории остался hook, вызывающий уже удалённую команду custodes.

Проверьте файл:

cat .git/hooks/pre-commit

Если он был создан Custodes, удалите его:

rm .git/hooks/pre-commit

Нужно временно обойти hook

Git позволяет выполнить:

git commit --no-verify

Это отключает все pre-commit проверки для данного коммита. Используйте обход только после ручной проверки staged diff и никогда не применяйте его для проталкивания реального секрета.