無料記事 2026.10.29 読了約12分

🩺launchdが6日間黙って死んでいた。24/7自動化を9項目・1コマンドで点検する仕組み

@bokuwalily ・ 90本

前回の autopilot 記事では、launchd から Claude を無人で走らせる構成を紹介しました。今回はその裏側、無人ジョブが止まったまま誰も気づかない問題と、その対処の話です。

無人自動化でいちばん怖いのは、派手なバグよりサイレント失敗です。launchd のジョブが exit 78 でクラッシュしていても、hooks のスクリプトが実行権限を失っていても、画面上は何も起きていないように見えます。

実際、私の環境では agentmemory が exit 78 のクラッシュループに入ったまま、6日間誰にも気づかれませんでした。6日です！その間ずっと、記憶サーバは落ちたままでした。そのとき automation-health.sh に書き残したコメントが、この記事の出発点です。

黙って死ぬものが多すぎた

自律ループを組むと、見張る対象がどんどん増えます。エンジニアでもない私の構成だけでも、これだけありました。

launchd ジョブ（skill-harvest / skill-curate / agentmemory など）
Stop hook / PreToolUse hook の実体スクリプト
会話ログを長期記憶に変える Stop hook
Obsidian Vault の自動更新
週次・月次バッチ（env-audit / plugin-purge / dotfiles-snapshot など）

これを毎日手で確認するのは無理でした。launchctl list を個別に叩いても、全体がどうなっているかは見えません。

そこで、全部まとめて点検して GREEN / WARN / FAIL の3段階で教えてくれる1コマンドを作りました。

💬 集客・導線設計と、AI導入・自動化のご相談はこちら

判定は ok / wn / ng の3つだけ

~/.claude/scripts/automation-health.sh の中心は、拍子抜けするくらい短いです。

fail=0; warn=0
ok()  { printf "  ${GRN}✓${RST} %s\n" "$1"; }
wn()  { printf "  ${YEL}⚠${RST} %s\n" "$1"; warn=$((warn+1)); }
ng()  { printf "  ${RED}✗${RST} %s\n" "$1"; fail=$((fail+1)); }

各チェックを ok / wn / ng のどれかで評価して、最後にまとめて判定します。

if   [ "$fail" -gt 0 ]; then
  printf "  ${RED}✗ FAIL${RST}  red=%d warn=%d\n\n" "$fail" "$warn"; exit 1
elif [ "$warn" -gt 0 ]; then
  printf "  ${YEL}⚠ WARN${RST}  warn=%d (致命的問題なし)\n\n" "$warn"; exit 0
else
  printf "  ${GRN}✓ ALL GREEN${RST}  全自動化が正常稼働\n\n"; exit 0
fi

RED が1つでもあれば exit 1、それ以外は exit 0 です。exit code を分けておくと、daily-brief.sh などから || で後続処理につなげられます。

9つの節で何を見ているか

スクリプトは9節に分かれています。主な判定を抜き出します。

1. launchd ジョブの生死

for job in com.shun.skill-harvest com.shun.skill-curate; do
  line=$(launchctl list 2>/dev/null | grep -E "\b${job}\b")
  if [ -z "$line" ]; then
    ng "$job: 未ロード (launchctl load し直しが必要)"
  else
    exitc=$(echo "$line" | awk '{print $2}')
    if [ "$exitc" = "0" ] || [ "$exitc" = "-" ]; then
      ok "$job: ロード済 / last exit=$exitc"
    else
      ng "$job: last exit=$exitc (前回失敗)"
    fi
  fi
done

launchctl list の2列目が前回の終了コードです。- はまだ起動していないだけ、0 は成功、それ以外は失敗として扱います。

2. hooks スクリプトの実在と実行権限

for h in "${hooks[@]}"; do
  f="$CLAUDE/hooks/$h"
  if   [ ! -f "$f" ]; then ng "$h: 不在"
  elif [ ! -x "$f" ]; then wn "$h: 実行権限なし (chmod +x 推奨)"
  else ok "$h"
  fi
done

settings.json に hook を書いても、実体が chmod +x されていなければ黙って飛ばされます。エラーも出ません。これを WARN で拾います。

3. skill-harvest のログ鮮度

ログファイルがあることと、最近走ったことは別の話です。だから age_h ヘルパで mtime からの経過時間を出し、48時間より古ければ WARN にしています。

4〜6. 記憶まわり

会話ログの件数と INDEX.md の鮮度（24時間以内か）、Obsidian の hot.md に自動更新マーカーがあるか、index.md の総ページ数が実ファイル数と一致するかを見ます。

remember 記憶層では、now.md に同じ要約が3回以上並んだら WARN にします。consolidate が遅れると、同じ要約が何度も追記されるからです。

dup=$(grep -vE '^\s*$|^##|^#' "$nowf" | sort | uniq -c | sort -rn | head -1 | awk '{print $1}')
if [ "${dup:-0}" -ge 3 ]; then
  wn "now.md に同一要約が ${dup} 回 (consolidate 遅延の兆候)"
fi

7. ディスク使用量と残骸

~/.claude の実効容量が 2GB 未満なら OK、5GB 未満なら WARN、それ以上は FAIL です。戻せるキャッシュ（.disabled-cache）は容量から引いて判定します。7日以上前の security_warnings_state_*.json が5個以上たまったら、退避を促す WARN も出します。

8. 週次・月次バッチのログ mtime

declare -a CRON_JOBS=(
  "weekly env-audit:$CLAUDE/logs/env-audit-latest.md:192"
  "monthly plugin-purge:$CLAUDE/logs/plugin-purge.log:744"
)
for entry in "${CRON_JOBS[@]}"; do
  IFS=":" read -r name path budget <<< "$entry"
  a=$(age_h "$path")
  if [ "$a" -le "$budget" ]; then ok "$name: ${a}h前"
  else wn "$name: ${a}h前 (budget ${budget}h 超過)"; fi
done

週次は 192時間（8日）、月次は 744時間（31日）を許容時間にして、超えたら WARN です。実際のリストには dotfiles-snapshot や plugin-usage など7本を入れています。

6日間見逃した「半生状態」

agentmemory のチェックだけは2段構えにしました。

am_line=$(launchctl list 2>/dev/null | awk '$3=="com.shun.agentmemory"{print $1" "$2}')
am_pid=${am_line%% *}; am_exit=${am_line##* }
if [ -z "$am_line" ]; then
  wn "com.shun.agentmemory が launchd に未ロード"
elif [ "$am_pid" = "-" ] && [ "$am_exit" != "0" ]; then
  ng "com.shun.agentmemory 停止中 (last exit=$am_exit) — クラッシュループの可能性"
else
  am_code=$(curl -s -o /dev/null -w '%{http_code}' -m 3 \
            http://localhost:3111/agentmemory/health 2>/dev/null || echo 000)
  if   [ "$am_code" = "200" ]; then ok "稼働中 (pid=$am_pid / health 200)"
  elif [ "$am_code" = "000" ]; then ng "プロセスは居るが port 3111 無応答"
  else ng "port 3111 は開くが /agentmemory/health=$am_code — worker 不在の半生状態"; fi
fi

理由はスクリプトのコメントに残してあります。

launchd の exit 78 クラッシュループが6日間誰にも気づかれず、さらに「ポートは開くが worker 不在で全API 404」の半生状態は死活監視では見えない。

厄介なのは後半です。プロセスは居るしポートも開いているので、launchd から見れば「起動中」です。でも API を叩くと全部 404 が返ってくる。PID を見るだけでは、この状態は絶対に見つかりません。

なので curl で /health を叩き、HTTP 200 が返るかまで確かめています。MCP サーバや API サーバを launchd で動かしている方は、/health を叩く1行を足しておくと、同じ見逃しを防げます。

cron と launchd の二重実行

9番目の節は、私が実際にやらかした件から生まれました。2026-06-01 に cron から launchd へ移行したとき、古い crontab を消し忘れていたんです。その結果、同じスクリプトが毎サイクル2回ずつ走っていました笑

cron_sh=$(crontab -l 2>/dev/null | grep -vE '^[[:space:]]*#' | \
          grep -oE '/[^ ]+\.sh' | xargs -n1 basename | sort -u)
launchd_sh=$(grep -hoE '/[^<> ]+\.sh' \
             ~/Library/LaunchAgents/com.shun.*.plist | xargs -n1 basename | sort -u)
dup=$(comm -12 <(printf '%s\n' "$cron_sh") <(printf '%s\n' "$launchd_sh") | \
      grep -vE '^[[:space:]]*$')
if [ -n "$dup" ]; then
  ng "cron と launchd の両方に登録され二重実行されるスクリプト: $(printf '%s' "$dup" | tr '\n' ' ')"
fi

両方からスクリプト名を抜き出して comm -12 で重なりを取るだけです。重なりが1つでもあれば FAIL にしています。

毎朝の daily-brief に1行だけ載せる

daily-brief.sh は毎朝 8:00 に launchd から起動します。その冒頭に、ヘルスチェックの結果を1行だけ入れています。

echo "## 🏥 環境ヘルス"
run_to 60 ~/.claude/scripts/automation-health.sh 2>&1 | tail -3 | head -1

tail -3 | head -1 で、最後のサマリ行（ALL GREEN / WARN / FAIL）だけを切り出します。

さらに brief 側では、ライブ疎通の確認で RED が出たときだけ ## 🚨 要対応の節が現れます。問題がない日は、この節そのものがありません。brief は ~/Desktop/Daily Brief/today-brief-YYYYMMDD.md に書き出されるので、朝デスクトップを開くと RED だけが目に入ります。

exit 1 を使えば、同じ考え方をファイル1つで再現できます。

bash ~/.claude/scripts/automation-health.sh || touch ~/Desktop/AUTOMATION_FAILED.md
bash ~/.claude/scripts/automation-health.sh && rm -f ~/Desktop/AUTOMATION_FAILED.md

失敗している間だけファイルがあって、直ったら消える。ダッシュボードを開かなくても、デスクトップが状態を教えてくれます。