Skip to content

Início rápido ​

O Obituary dá uma vida útil a arquivos e pastas. Quando ela termina, eles são enterrados em um cemitério; você pode ressuscitá-los a qualquer momento durante o período de retenção (7 dias por padrão), e eles só são realmente excluídos depois disso. Ele foi criado para agentes de IA: scripts de depuração, logs, capturas de tela e saídas de testes produzidos por um agente têm uma vida útil desde o momento em que são criados. Ninguém precisa se lembrar de limpar, e o rm -rf do agente não destrói mais nada para sempre.

1. Instalar ​

Windows 10 / 11, macOS e Linux (x64 e ARM64):

WindowsmacOSLinux
Instalar comScoop, o script install.ps1 (winget em revisão)Homebrew, o script install.sho script install.sh
Verificar expirações a cada 5 minutosprocesso residente na bandeja, Agendador de Tarefas como alternativaagente launchd do usuáriotemporizador systemd --user; crontab do usuário sem systemd
CLI, cemitério e ressurreição, registro automático (opcional), guardião de exclusão, integração com agentes (hooks, Skill, MCP), contêineres Docker, políticas de pastassimsimsim
Bandeja, janela pequena, menus de contexto, datas de enterro no Explorer, menu Iniciar e atalhos da área de trabalhosimuse a CLI: obit list, obit graveyard, obit resurrectcomo no macOS
Modo Lixeirasimapenas o cemitérioapenas o cemitério

O jeito mais fácil: deixe o agente fazer isso. Envie esta frase para o agente que você usa (Claude Code, Codex, Cursor e outros). Ele instala o Obituary, conecta-o a si mesmo e para quando a decisão for sua.

text
Read https://obituary.woodfish.site/agent-install.md and follow it to install Obituary and connect it to yourself.

Manualmente: escolha seu sistema operacional abaixo e execute obit doctor para verificar a instalação.

macOS / Linux ​

No macOS, o Homebrew instala em uma linha:

bash
brew install --cask woodfishhhh/tap/obituary

Ou baixe e leia o script de instalação e depois execute-o (macOS e 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

O script instala a versão mais recente por padrão (--version <version> escolhe outra). O arquivo é baixado em quatro partes ao mesmo tempo (algumas rotas limitam a velocidade de cada conexão) e volta para uma única conexão quando isso não funciona. Ele detecta o sistema operacional e a arquitetura, verifica o SHA-256 da mesma fonte de download e instala obit e obitd em ~/.local/bin. Siga as instruções do PATH e execute obit --version. Use --mirror cn para o espelho da China continental; o script está em https://cn.obituary.woodfish.site/install.sh.

Na primeira utilização no macOS, execute obit --version e obitd --help. Se o Gatekeeper pedir aprovação, abra Ajustes do Sistema → Privacidade e Segurança, escolha “Abrir Mesmo Assim” para cada executável cuja origem você verificou e tente novamente.

No WSL, mantenha os projetos e a configuração do agente no sistema de arquivos Linux (por exemplo, em ~/projects). Montagens do Windows, como /mnt/c, podem não aceitar as renomeações seguras necessárias para a instalação; a operação informa um erro e preserva a configuração original. Você também pode usar diretamente a edição do 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
  • As três opções baixam o mesmo arquivo do release do GitHub e verificam o SHA-256 antes de descompactá-lo; uma divergência interrompe a instalação.
  • Assinatura de código: a SignPath.io fornece assinatura de código gratuita, e o certificado é da SignPath Foundation. Consulte a política de assinatura de código e a política de privacidade.
  • O Obituary ainda não tem assinatura de código. Se você baixar o arquivo pelo navegador, o Windows pode mostrar “O Windows protegeu o computador”; escolha “Mais informações → Executar assim mesmo”. O Scoop, o winget e o script de instalação normalmente não exibem esse aviso.
  • A janela pequena obit-gui.exe precisa do runtime WebView2 (integrado ao Windows 11 e presente na maioria dos computadores com Windows 10) e funciona apenas em x64; a versão ARM64 inclui a linha de comando e a bandeja. Depois, verifique a instalação:
powershell
obit doctor              # read-only check: PATH, obitd, runner, Claude Code / Codex integration, data directory, ledger, config (--json)

2. Conectar seus agentes ​

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

Reinicie o agente depois. Para outros agentes, o servidor MCP e o Agent Skill, consulte Conecte os agentes.

No macOS / Linux, o Claude Code usa ~/.claude, o Codex usa ~/.codex e as Skills compartilhadas usam ~/.agents/skills. As substituições CLAUDE_CONFIG_DIR e CODEX_HOME também são respeitadas.

Ative o agendador do usuário para verificar expirações a cada 5 minutos:

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

O macOS usa o launchd do usuário conectado; o Linux usa systemd --user. No Linux sem systemd, agende obitd --once a cada 5 minutos no crontab do usuário, fornecendo os caminhos absolutos para obitd, o diretório de dados --home e o diretório de configuração --config-dir. Os hooks do agente também iniciam uma verificação em segundo plano quando chega a hora do trabalho.

3. Comandos comuns ​

Substitua <id> pelo número de um recibo de obit add ou obit bury, ou pelo número mostrado em 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

Para o restante, consulte Comandos.

Próximos passos ​

Para descobrirLeia
Como funcionam o registro, o enterro, a ressurreição e a exclusão permanente, e onde fica o cemitérioComo funciona
Conectar Claude Code, Codex e outros agentesConecte os agentes
O que entra: registros de agentes, menu de contexto, registro automático opcionalO que entra
Transformar o rm -rf de um agente em um enterro que pode ser desfeitoGuardião de exclusão
O que acontece quando um agente acessa um arquivo enterradoAvisos do cemitério
Vidas úteis para pastas como Downloads e Área de TrabalhoPolíticas de pastas
Usar o Obituary sem a linha de comandoJanela, bandeja e menu de contexto
Contêineres Docker iniciados em uma sessãoContêineres Docker
Todos os comandosComandos
Remover o ObituaryDesinstalar
Qualquer outra coisaFAQ

MIT