Inicio rápido
Obituary da a los archivos y carpetas una vida útil. Cuando se agota, se entierran en un cementerio; puedes resucitarlos en cualquier momento durante el periodo de retención (7 días de forma predeterminada), y solo después se eliminan de verdad. Está diseñado para agentes de IA: los scripts de depuración, registros, capturas de pantalla y resultados de pruebas que produce un agente tienen una vida útil desde el momento en que se crean. Nadie tiene que acordarse de limpiar, y el rm -rf de un agente ya no destruye nada para siempre.
1. Instalar
Windows 10 / 11, macOS y Linux (x64 y ARM64):
| Windows | macOS | Linux | |
|---|---|---|---|
| Instalar con | Scoop, el script install.ps1 (winget en revisión) | Homebrew, el script install.sh | el script install.sh |
| Comprobar la caducidad cada 5 minutos | proceso residente de la bandeja, Programador de tareas como alternativa | agente launchd del usuario | temporizador systemd --user; crontab de usuario si no hay systemd |
| CLI, cementerio y resurrección, registro automático (opcional), guardia de eliminación, integración con agentes (hooks, Skill, MCP), contenedores Docker, políticas de carpetas | sí | sí | sí |
| Bandeja, ventana pequeña, menús contextuales, fechas de entierro en el Explorador, menú Inicio y accesos directos del escritorio | sí | en su lugar, la CLI: obit list, obit graveyard, obit resurrect | como en macOS |
| Modo de papelera de reciclaje | sí | solo el cementerio | solo el cementerio |
Lo más fácil: deja que lo haga tu agente. Envía esta frase al agente que utilizas (Claude Code, Codex, Cursor, etc.). Instalará Obituary, se conectará a sí mismo y se detendrá cuando la decisión te corresponda.
Read https://obituary.woodfish.site/agent-install.md and follow it to install Obituary and connect it to yourself.A mano: elige tu sistema operativo a continuación y ejecuta obit doctor para comprobar la instalación.
macOS / Linux
En macOS, Homebrew lo instala en una sola línea:
brew install --cask woodfishhhh/tap/obituaryTambién puedes descargar y leer el script de instalación y después ejecutarlo (macOS y Linux):
curl -fsSL https://raw.githubusercontent.com/woodfishhhh/obituary/main/install.sh -o install.sh
bash install.sh
# Custom directory: --install-dir "$HOME/bin"; preview only: --dry-runEl script instala la última versión de forma predeterminada (con --version <version> puedes elegir otra). El archivo se descarga en cuatro partes a la vez (algunas rutas limitan la velocidad de cada conexión) y vuelve a una sola conexión si eso no funciona. Detecta el sistema operativo y la arquitectura, verifica SHA-256 desde la misma fuente de descarga e instala obit y obitd en ~/.local/bin. Sigue las instrucciones para PATH y ejecuta obit --version. Usa --mirror cn para el espejo de China continental; su script está en https://cn.obituary.woodfish.site/install.sh.
La primera vez que uses Obituary en macOS, ejecuta obit --version y obitd --help. Si Gatekeeper solicita autorización, abre Ajustes del Sistema → Privacidad y seguridad, elige «Abrir igualmente» para cada ejecutable cuyo origen hayas verificado y vuelve a ejecutar el comando.
En WSL, mantén los proyectos y la configuración del agente en el sistema de archivos de Linux (por ejemplo, en ~/projects). Las monturas de Windows como /mnt/c pueden no admitir los cambios de nombre seguros necesarios para la instalación; la operación mostrará un error y conservará la configuración original. También puedes usar directamente la edición de Obituary para Windows.
Windows
scoop bucket add obituary https://github.com/woodfishhhh/scoop-bucket
scoop install obituary# In review, available once approved
winget install woodfishhhh.Obituary# Install script: download it, read it, then run it
# (installs to %LOCALAPPDATA%\Programs\obituary, adds it to your user PATH, creates a Start menu shortcut)
irm https://raw.githubusercontent.com/woodfishhhh/obituary/main/packaging/install.ps1 -OutFile install.ps1
.\install.ps1 # installs the latest release; -WhatIf previews, -NoPath leaves PATH alone- Los tres descargan el mismo archivo desde la versión publicada en GitHub y comprueban su SHA-256 antes de descomprimirlo; una discrepancia detiene la instalación.
- Firma de código: SignPath.io proporciona la firma de código gratuita y SignPath Foundation proporciona el certificado. Consulta la política de firma de código y la política de privacidad.
- Obituary todavía no tiene firma de código. Si descargas el archivo con un navegador, Windows puede mostrar «Windows protegió tu PC»; elige «Más información → Ejecutar de todas formas». Scoop, winget y el script de instalación normalmente no provocan este aviso.
- La ventana pequeña
obit-gui.exenecesita el runtime de WebView2 (integrado en Windows 11 y presente en la mayoría de los equipos con Windows 10) y solo está disponible para x64; la compilación ARM64 incluye la línea de comandos y la bandeja. Después, comprueba la instalación:
obit doctor # read-only check: PATH, obitd, runner, Claude Code / Codex integration, data directory, ledger, config (--json)2. Conectar agentes
obit init -g # Claude Code, all projects; also the Skill (and desktop integration on Windows)
obit init -g --agent codex # CodexReinicia el agente después. Para otros agentes, el servidor MCP y Agent Skill, consulta Conectar agentes.
En macOS / Linux, Claude Code usa ~/.claude, Codex usa ~/.codex y las Skills compartidas usan ~/.agents/skills. También se respetan las anulaciones CLAUDE_CONFIG_DIR y CODEX_HOME.
Activa el programador del usuario para comprobar los vencimientos cada 5 minutos:
obit daemon enable --dry-run
obit daemon enable
obit doctormacOS usa el launchd del usuario que ha iniciado sesión; Linux usa systemd --user. En Linux sin systemd, programa obitd --once cada 5 minutos en el crontab del usuario y proporciona las rutas absolutas de obitd, el directorio de datos --home y el directorio de configuración --config-dir. Los hooks del agente también inician una comprobación en segundo plano cuando llega el momento de trabajar.
3. Comandos comunes
Sustituye <id> por el número de un recibo de obit add o obit bury, o por el número que aparece en obit list / obit graveyard.
obit add debug.log 2h # bury it in 2 hours (alias: mark)
obit list # what is left and for how long
obit extend <id> 1d # one more day
obit bury old-build # bury right away
obit graveyard # what is in the graveyard and when it will be purged
obit resurrect <id> # put it back, never overwriting
obit resurrect --last # undo the last deletionTodo lo demás está en Comandos.
Siguiente
| Para saberlo | Leer |
|---|---|
| Cómo funcionan el registro, el entierro, la resurrección y la eliminación definitiva, y dónde está el cementerio | Cómo funciona |
| Cómo conectar Claude Code, Codex y otros agentes | Conectar agentes |
| Qué se incluye: registros de agentes, menú contextual y registro automático opcional | Qué se incluye |
Convertir el rm -rf de un agente en un entierro que puedas deshacer | Guardia de eliminación |
| Qué ocurre cuando un agente accede a un archivo enterrado | Avisos del cementerio |
| Vidas útiles para carpetas como Descargas y Escritorio | Políticas de carpetas |
| Usar Obituary sin la línea de comandos | Ventana, bandeja y menú contextual |
| Contenedores Docker iniciados en una sesión | Contenedores Docker |
| Todos los comandos | Comandos |
| Eliminar Obituary | Desinstalar |
| Cualquier otra cosa | Preguntas frecuentes |