Skip to main content
Файл .harviignore позволяет контролировать, к каким файлам и папкам Harvi Code может получать доступ. Это работает как .gitignore для Git — просто укажи паттерны файлов, которые агент не должен читать или изменять.

​
Зачем это нужно

.harviignore помогает:
  • Защитить конфиденциальные данные (пароли, ключи API)
  • Исключить большие файлы и артефакты сборки
  • Ограничить область работы агента только нужными файлами
Создай файл .harviignore в корне workspace и добавь туда паттерны файлов для игнорирования. Harvi Code автоматически отслеживает изменения в этом файле.

​
Синтаксис паттернов

Используется тот же синтаксис, что и в .gitignore: 
node_modules/          # игнорировать всю папку
*.log                  # все файлы с расширением .log
config/secrets.json    # конкретный файл
!important.log         # исключение — этот файл НЕ игнорируется
build/                 # папка со сборкой
docs/**/*.md           # все .md файлы в docs и подпапках
Подробнее о синтаксисе можно почитать в документации Git.

​
Как это работает

​
Инструменты с полной блокировкой

Эти инструменты проверяют .harviignore перед каждой операцией:
  • read_file — не читает игнорируемые файлы
  • create_file — не создаёт игнорируемые файлы
  • str_replace — не изменяет игнорируемые файлы

​
Списки файлов

  • list_files и упоминания @directory — игнорируемые файлы помечаются символом 🔒 (если включена настройка showHarviIgnoredFiles)
  • Информация о workspace фильтруется автоматически

​
Упоминания контекста

  • @directory — игнорируемые файлы фильтруются или помечаются [🔒]
  • Отдельные файлы — вместо содержимого возвращается “(File is ignored by .harviignore)“

​
Выполнение команд

harvi_cmd проверяет команды вроде cat или grep — если они обращаются к игнорируемым файлам, выполнение блокируется.

​
Важные ограничения

  • .harviignore работает только внутри текущего workspace
  • Защита команд работает только для предопределённого списка команд
  • Это не полная песочница — просто контроль доступа к файлам

​
Что видит пользователь

  • Символ 🔒 — игнорируемые файлы помечаются в списках (зависит от настройки showHarviIgnoredFiles)
  • Сообщения об ошибках — если операция заблокирована, агент получает ошибку и уведомление в чате
  • Текст вместо содержимого — “(File is ignored by .harviignore)” для отдельных файлов
Используй .harviignore, чтобы безопасно работать с Harvi Code и не беспокоиться о случайном доступе к важным файлам.