Skip to content

快速開始 ​

Obituary 為檔案和資料夾設定壽命。壽命到期後,它們會被下葬到墓地;在保留期內(預設 7 天)隨時可以復活,只有過了保留期才會真正刪除。它是為 AI agent 打造的:agent 產生的除錯指令碼、日誌、截圖和測試輸出,從建立的那一刻起就帶有壽命。沒有人需要記得清理,agent 的 rm -rf 也不再把任何東西永久摧毀。

1. 安裝 ​

Windows 10 / 11、macOS 和 Linux(x64 和 ARM64):

WindowsmacOSLinux
安裝方式Scoop、install.ps1 指令碼(winget 審核中)Homebrew、install.sh 指令碼install.sh 指令碼
每 5 分鐘檢查到期常駐系統匣程序,工作排程器作為備援使用者的 launchd 代理程式systemd --user 計時器;沒有 systemd 時使用使用者 crontab
命令列、墓地與復活、自動登記(可選)、刪除護欄、agent 整合(hook、Skill、MCP)、Docker 容器、資料夾策略有有有
系統匣、小視窗、內容功能表、檔案總管中的下葬日期、開始功能表和桌面捷徑有改用命令列:obit list、obit graveyard、obit resurrect與 macOS 相同
資源回收筒模式有僅墓地僅墓地

最簡單的方法:讓 agent 幫你處理。 把這句話傳給你使用的 agent(Claude Code、Codex、Cursor……都可以)。它會安裝 Obituary、連接到自己,並在需要你決定的地方停下來:

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

手動安裝: 在下方選擇你的作業系統,然後執行 obit doctor 檢查安裝結果。

macOS / Linux ​

在 macOS 上,Homebrew 一行就能完成安裝:

bash
brew install --cask woodfishhhh/tap/obituary

或者下載並閱讀安裝指令碼,再執行它(macOS 和 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

指令碼預設安裝最新發行版(--version <version> 可選擇其他版本)。壓縮檔會同時分成四個部分下載(有些路線會限制每個連線的速度),失敗時會退回單一連線。它會偵測作業系統和架構,從同一個下載來源核對 SHA-256,並將 obit 和 obitd 安裝到 ~/.local/bin。請依照 PATH 指示操作,然後執行 obit --version。中國大陸鏡像請使用 --mirror cn;指令碼位於 https://cn.obituary.woodfish.site/install.sh。

在 macOS 首次使用時,請執行 obit --version 和 obitd --help。如果 Gatekeeper 要求核准,請開啟「系統設定 → 隱私權與安全性」,對每個已核對來源的執行檔選擇「強制打開」,然後重試命令。

在 WSL 中,請把專案和 agent 設定放在 Linux 檔案系統(例如 ~/projects)中。/mnt/c 等 Windows 掛載路徑可能不支援安裝所需的安全改名;操作會回報錯誤並保留原始設定。你也可以直接使用 Windows 版 Obituary。

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
  • 三種方式都會從 GitHub 發行版下載同一個壓縮檔,並在解壓縮前核對 SHA-256;不一致就會停止安裝。
  • 程式碼簽署:由 SignPath.io 提供免費程式碼簽署,憑證由 SignPath Foundation 提供。請參閱程式碼簽署政策和隱私政策。
  • Obituary 目前尚未簽署程式碼。如果用瀏覽器下載壓縮檔,Windows 可能顯示「Windows 已保護你的電腦」;請選擇「更多資訊 → 仍要執行」。Scoop、winget 和安裝指令碼通常不會觸發這個提示。
  • 小視窗 obit-gui.exe 需要 WebView2 執行階段(Windows 11 內建,多數 Windows 10 電腦也已具備),目前只有 x64 版本;ARM64 版本提供命令列和系統匣。 然後檢查安裝:
powershell
obit doctor              # read-only check: PATH, obitd, runner, Claude Code / Codex integration, data directory, ledger, config (--json)

2. 連接你的 agent ​

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

之後重新啟動 agent。其他 agent、MCP 服務和 Agent Skill 請參閱接入 agent。

在 macOS / Linux 上,Claude Code 使用 ~/.claude,Codex 使用 ~/.codex,共用 Skill 使用 ~/.agents/skills。也會遵守 CLAUDE_CONFIG_DIR 和 CODEX_HOME 覆寫設定。

啟用使用者排程器,每 5 分鐘檢查一次到期項目:

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

macOS 使用已登入使用者的 launchd;Linux 使用 systemd --user。沒有 systemd 的 Linux,可以在使用者 crontab 中每 5 分鐘排程一次 obitd --once,並提供 obitd、--home 資料目錄和 --config-dir 設定目錄的絕對路徑。agent hook 也會在工作到期時啟動背景檢查。

3. 常用命令 ​

將 <id> 替換成 obit add 或 obit bury 回執中的編號,或 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

其他功能請參閱命令。

接下來 ​

想了解閱讀
登記、下葬、復活和永久刪除的運作方式,以及墓地的位置運作方式
連接 Claude Code、Codex 和其他 agent接入 agent
會納入哪些內容:agent 登記、內容功能表、可選的自動登記哪些項目會納入
把 agent 的 rm -rf 變成可以復原的下葬刪除護欄
agent 觸及已下葬檔案時會發生什麼墓地通知
為下載和桌面等資料夾設定壽命資料夾策略
不使用命令列也能使用 Obituary小視窗、系統匣和內容功能表
工作階段中啟動的 Docker 容器Docker 容器
所有命令命令
移除 Obituary解除安裝
其他內容常見問題

MIT