Какие файлы регистрируются
Агент и вы решаете, а Obituary хоронит вовремя
Агент и вы решаете, что попадает в Obituary (по умолчанию [proposals] mode = "off"):
- Агент регистрирует свои результаты. Для отладочных сценариев, журналов и снимков экрана он задаёт срок жизни командой
obit mark <path> 2d, создаёт временное место командойobit mktemp 1d, а сомнительные объекты хоронит командойobit bury.obit initобъясняет агенту эти правила. - Вы добавляете объекты через контекстное меню. В Windows щёлкните правой кнопкой файл или папку в Проводнике, выберите «Add to Obituary», а затем срок 1, 7 или 30 дней либо «Bury now (recoverable)». См. окно, область уведомлений и контекстное меню.
- Правила для папок задают срок жизни папкам вроде «Загрузки». См. правила для папок.
Зарегистрированные объекты хоронятся по истечении срока и ещё семь дней доступны для воскрешения в исходном виде. Ничего другого автоматически не добавляется.
- Уборка в конце сеанса. Перед остановкой агента Claude Code или Codex Obituary перечисляет файлы, созданные в этом сеансе и ещё не разобранные. Агенту предлагается задать срок жизни или похоронить отладочные сценарии, журналы и снимки экрана, сохранив результаты работы. Уведомление появляется не более одного раза за сеанс и отсутствует при пустом списке; другие агенты получают его в начале следующего сеанса. Отключить его можно параметром
[hooks] session_cleanup = false. - При обновлении со старой версии настройка один раз выключается. Ранее автоматически зарегистрированные зависимости, результаты сборки и кэши остаются на месте без срока жизни.
Включите автоматическую регистрацию, когда вы хотите
Включите режим в Settings или For you либо задайте [proposals] mode в config.toml.
"tiered"напрямую регистрирует файлы, созданные агентом в этом сеансе, и контейнеры Docker, запущенные для проекта. Файл регистрируется напрямую, только если хук видел запись, файл отсутствовал в начальном снимке, а время создания позже начала сеанса. После регистрации агент получает уведомление, запись появляется вobit proposalsи в разделе «Handled automatically» страницы For you. Уже существовавшие файлы и файлы, запись которых хук не видел, становятся только предложениями.obit approve <id>регистрирует предложенные объекты; после этого совпадающие правила проекта могут регистрировать объекты напрямую.obit reject <id>запрещает автоматическую регистрацию в этом проекте."auto"напрямую регистрирует всё найденное автоматической регистрацией и сообщает вам после этого."ask"сначала превращает всё в предложения и ждёт одобрения.
obit proposals # proposals waiting for you, and what was registered without asking
obit approve 3 # approve: register what it lists
obit reject 3 # reject
obit spare 12 # undo an automatic registration: it stays where it is, without a lifespan
obit extend 12 1w # keep it longer- Зависимости, результаты сборки и кэши (
node_modules,dist,.turbo,__pycache__и тому подобное) не регистрируются и не предлагаются автоматически ни в одном режиме. Для очистки зарегистрируйте их сами командойobit mark. - Большие объекты, созданные не агентом, тоже становятся предложениями, если занимают более 1 ГБ или содержат более 200 файлов.
- Разница сеанса. В начале делается снимок, который хранится в каталоге данных и не добавляется в репозиторий; в конце его сравнивают. Совпадения правил обрабатываются выбранным режимом, новые файлы без подходящего правила не регистрируются и не предлагаются.
- После смены режима фоновый процесс заново классифицирует ожидающие предложения.
- Перед захоронением Git проверяется ещё раз. Объект, зарегистрированный правилом или предложением, не хоронят, если к моменту истечения он уже попал в коммит.
- Предложения истекают сами. Зафиксированные в коммите или удалённые объекты убираются из предложения; пустое предложение отзывается, записывается в журнал аудита и не считается отказом.
Правила
obit rules # the rules in effect here (built-in plus a trusted .obitrules)
obit rules check debug.log out/ # preview what would be registered and by which rule (changes nothing)
obit rules apply debug.log # register by ruleobit rules apply в любой момент регистрирует объект по правилам; при включённой автоматической регистрации хуки используют их тоже. Встроенные правила охватывают обычный мусор агента: .playwright-mcp/, test-results/, *.log и другое. Резервные копии *.bak, *.bak.*, *.orig, *.rej, *.old, *.backup и *~ хранятся семь дней, а LOG.old LevelDB не трогают. Файл .obitrules в корне проекта использует синтаксис .gitignore и указывает срок после каждого шаблона.
output/** 7d # every item under output gets its own lifespan
!output/keep/** # never touch (negation wins, even over registering a parent folder)
test-results/ off # turn off a built-in ruleВ отличие от .gitignore, отрицания имеют приоритет над последним совпадением. В Windows регистр букв не учитывается. Неверный шаблон, например незакрытый [, указывает имя файла и строку и приостанавливает автоматическую регистрацию проекта.
Единицы времени: s, m, h, d и w; их можно сочетать, например 1d12h.
Жесткие правила автоматической регистрации
- Регистрируются только неотслеживаемые объекты внутри рабочего дерева Git.
- Папка, содержащая хотя бы один отслеживаемый файл, не затрагивается.
- Если Git не отвечает, объект пропускается. Уже заданный срок жизни никогда не сокращается.
- Отклонённый проект ни в одном режиме не регистрируется напрямую. Применение правил для папок и доверие к
.obitrulesвсегда требуют вашего решения.
Правила проекта должны быть доверенными в первую очередь
Собственный .obitrules репозитория не действует, пока вы не проверите его и не выполните obit trust. Это не позволяет чужому репозиторию использовать правила для ваших личных файлов. При доверии сохраняется SHA-256 файла; любое изменение требует новой проверки. В неинтерактивном сеансе нужен --yes, а в CI можно задать OBIT_TRUST_PROJECT_RULES=1.
Временная папка, которая погребает себя
$dir = obit mktemp 1d # .obit/tmp/ in a project (not in Git), otherwise the system temp folderВ bash: dir=$(obit mktemp 1d).