Skip to content

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):

WindowsmacOSLinux
Instalar conScoop, el script install.ps1 (winget en revisión)Homebrew, el script install.shel script install.sh
Comprobar la caducidad cada 5 minutosproceso residente de la bandeja, Programador de tareas como alternativaagente launchd del usuariotemporizador 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 carpetassísísí
Bandeja, ventana pequeña, menús contextuales, fechas de entierro en el Explorador, menú Inicio y accesos directos del escritoriosíen su lugar, la CLI: obit list, obit graveyard, obit resurrectcomo en macOS
Modo de papelera de reciclajesísolo el cementeriosolo 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.

text
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:

bash
brew install --cask woodfishhhh/tap/obituary

También puedes descargar y leer el script de instalación y después ejecutarlo (macOS y Linux):

bash
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-run

El 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 ​

powershell
scoop bucket add obituary https://github.com/woodfishhhh/scoop-bucket
scoop install obituary
powershell
# In review, available once approved
winget install woodfishhhh.Obituary
powershell
# 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.exe necesita 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:
powershell
obit doctor              # read-only check: PATH, obitd, runner, Claude Code / Codex integration, data directory, ledger, config (--json)

2. Conectar agentes ​

powershell
obit init -g                 # Claude Code, all projects; also the Skill (and desktop integration on Windows)
obit init -g --agent codex   # Codex

Reinicia 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:

bash
obit daemon enable --dry-run
obit daemon enable
obit doctor

macOS 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.

powershell
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 deletion

Todo lo demás está en Comandos.

Siguiente ​

Para saberloLeer
Cómo funcionan el registro, el entierro, la resurrección y la eliminación definitiva, y dónde está el cementerioCómo funciona
Cómo conectar Claude Code, Codex y otros agentesConectar agentes
Qué se incluye: registros de agentes, menú contextual y registro automático opcionalQué se incluye
Convertir el rm -rf de un agente en un entierro que puedas deshacerGuardia de eliminación
Qué ocurre cuando un agente accede a un archivo enterradoAvisos del cementerio
Vidas útiles para carpetas como Descargas y EscritorioPolíticas de carpetas
Usar Obituary sin la línea de comandosVentana, bandeja y menú contextual
Contenedores Docker iniciados en una sesiónContenedores Docker
Todos los comandosComandos
Eliminar ObituaryDesinstalar
Cualquier otra cosaPreguntas frecuentes

MIT