Qué archivos se registran
El agente y tú decidís; Obituary entierra a tiempo
El agente y tú decidís qué entra en Obituary (por defecto, [proposals] mode = "off"):
- El agente registra sus propios resultados. Asigna una vida útil con
obit mark <path> 2da los scripts de depuración, registros y capturas que escribe, crea espacio temporal conobit mktemp 1dy entierra conobit burylo que no sabe si debe conservar.obit initexplica este comportamiento al agente. - Tú añades elementos desde el menú contextual. En Windows, haz clic derecho en archivos o carpetas del Explorador (puedes seleccionar varios), elige «Add to Obituary» y después 1, 7 o 30 días, o «Bury now (recoverable)». Consulta Ventana, bandeja y menú contextual.
- Las políticas de carpetas asignan una vida útil a carpetas como Descargas. Consulta Políticas de carpetas.
Todo lo registrado se entierra cuando caduca y puede resucitarse tal como estaba durante siete días. Nada más se registra por sí solo.
- Limpieza al final de la sesión. Cuando un agente de Claude Code o Codex va a detenerse, Obituary enumera los archivos que creó en esa sesión y aún no se han clasificado. Le pide asignar una vida útil o enterrar scripts, registros y capturas, conservando los entregables. Ocurre como máximo una vez por sesión y no muestra nada si no hay elementos; los demás agentes reciben el aviso al iniciar la siguiente sesión.
[hooks] session_cleanup = falselo desactiva. - Al actualizar desde una versión anterior, este ajuste se desactiva una vez y las dependencias, salidas de compilación y cachés registrados automáticamente antes quedan en su lugar, sin vida útil.
Activa el registro automático cuando lo desees
Actívalo desde Settings o For you, o define [proposals] mode en config.toml.
"tiered"registra directamente los archivos creados por el agente en esta sesión y los contenedores Docker iniciados para el proyecto. Un archivo solo entra directamente si el hook observó la escritura, no estaba en la instantánea inicial y su fecha de creación es posterior al inicio de la sesión. Se avisa al agente y aparece enobit proposalsy en «Handled automatically» de For you. Los archivos anteriores a la sesión o cuya escritura no observó el hook solo generan una propuesta.obit approve <id>registra lo propuesto para el proyecto; desde entonces sus coincidencias de reglas pueden registrarse directamente.obit reject <id>rechaza el registro automático en este proyecto."auto"registra directamente todo lo que encuentre el registro automático y te informa después."ask"convierte todo en una propuesta pendiente de aprobación.
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- Dependencias, salidas de compilación y cachés (
node_modules,dist,.turbo,__pycache__y similares) nunca se registran ni se proponen automáticamente. Para limpiarlos, regístralos tú conobit mark. - Los elementos grandes que no creó el agente también se proponen si superan 1 GB o contienen más de 200 archivos.
- Diferencia de sesión. Se toma una instantánea al comenzar la sesión, se guarda en el directorio de datos y no se añade nada al repositorio. Al terminar se compara; las coincidencias de reglas siguen el modo y los archivos nuevos sin regla no se registran ni se proponen.
- Después de cambiar el modo, el proceso en segundo plano vuelve a clasificar las propuestas pendientes.
- Git se consulta de nuevo antes del entierro. Lo registrado por regla o propuesta no se entierra si ya está en un commit cuando caduca.
- Las propuestas caducan solas. Los elementos confirmados o eliminados se quitan, y una propuesta vacía se retira, queda en el registro de auditoría y no cuenta como rechazo.
Reglamento
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 registra según las reglas en cualquier momento; con el registro automático activo, los hooks también las usan. Las reglas incluidas cubren residuos habituales como .playwright-mcp/, test-results/ y *.log. Las copias de seguridad *.bak, *.bak.*, *.orig, *.rej, *.old, *.backup y *~ se conservan siete días, pero LOG.old de LevelDB se deja intacto. El archivo .obitrules en la raíz usa sintaxis de .gitignore y una vida útil después de cada patrón.
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 ruleA diferencia de .gitignore, las negaciones tienen prioridad sobre la última coincidencia. En Windows no se distingue entre mayúsculas y minúsculas. Un patrón inválido, como [ sin cerrar, produce un error con archivo y línea y detiene el registro automático del proyecto.
Las unidades son s, m, h, d y w; se pueden combinar, por ejemplo 1d12h.
Reglas estrictas para el registro automático
- Solo se registran elementos sin seguimiento dentro de un árbol de trabajo Git.
- Una carpeta que contenga aunque sea un archivo seguido nunca se toca.
- Si Git no responde, se omite.
- Nunca se acorta una vida útil existente.
- Un proyecto rechazado nunca se registra directamente. Las políticas de carpetas y la confianza en
.obitrulessiempre esperan tu decisión.
Las reglas del proyecto deben ser confiables primero
El .obitrules del repositorio no tiene efecto hasta que lo revises y ejecutes obit trust. Así, un repositorio ajeno no puede usar reglas para tomar archivos privados. Se guarda el SHA-256 del archivo; cualquier cambio exige una nueva revisión. Las sesiones no interactivas necesitan --yes y en CI puedes establecer OBIT_TRUST_PROJECT_RULES=1.
Una carpeta temporal que se entierra a sí misma
$dir = obit mktemp 1d # .obit/tmp/ in a project (not in Git), otherwise the system temp folderEn bash: dir=$(obit mktemp 1d).