Devotd Github
新着AIエージェント

kevin-liu-01/headroom 2.2 — エージェントセッションが残したプロセスの一覧と Kill ボタン

macOS で Claude・Codex のエージェントセッション終了後に launchd に養子として取り込まれ残るプロセスを一覧表示し、ユーザーが自分で確認して終了できるようにした変更である。

リポジトリ情報kevin-liu-01/headroom ↗

macOS で Claude・Codex のエージェントセッション終了後に launchd に養子として取り込まれ残るプロセスを一覧表示し、ユーザーが自分で確認して終了できるようにした変更である。

GitHub の説明: Memory alerts for Macs that run AI coding agents: which Claude session owns the memory, alerts before macOS runs out, and advice relayed to agents through a CLI, HTTP API, Claude Code hook and MCP server.

スター
★ 11
フォーク
0
言語
Swift
ライセンス
MIT
原文を見る ↗GitHub で見る ↗

kevin-liu-01/headroom の 2026-10-28 のコミット(3c27f73)は macOS アプリに「残りプロセス(leftovers)」一覧と Kill ボタンを追加した。このアプリは Claude と Codex のデスクトップアプリ、そのエージェントセッション、セッションが起動したプロセスがどれだけメモリを使うかを集め、メニューバーに表示する。コミットはこの変更を 2.2 と記載している。

対象となるのは、セッションやシェル、スクリプトが終了したのに生き残ったプロセスである。macOS ではこのようなプロセスの親が launchd(pid 1)に変わり、エージェントのプロセスツリーから外れ、他の行にも現れない。Headroom はカーネルが保持している元の親の pid バージョン情報(proc_pidinfo の PROC_PIDUNIQIDENTIFIERINFO)を読み取り、launchd が自ら起動したアプリではなく、養子になったプロセスだけを選別する。同じプロセスグループ内で 2 秒以内に開始されたものは一つの作業としてまとめられるため、シェルが残した tail -F | grep パイプラインやテストブラウザのクラッシュハンドラがまとまって現れる。ウィンドウには種別、コマンド、フォルダ、コピー可能な pid、経過時間、メモリ、CPU 時間がコアの 1 パーセント分増加した最終サンプルが並べて置かれ、メモリの大きい順に、グループの見出し("5 leftovers, 4.3 GB")とともに重い作業の下に配置される。CLI には headroom leftovers 表、--json、headroom status の件数 1 行が追加され、実装は新しいファイル Sources/HeadroomCore/Leftovers.swift とテストファイル LeftoverTests.swift として入った。

終了はユーザーが行う。Kill ボタンは 5 秒以内に再度押されなければ実行されず、まだ同じプロセスを指している pid すべてに SIGTERM を送ったあと、5 秒後に残っているものには SIGKILL を送る。Headroom 自身がプロセスを殺すことはない。経過時間の基準は設定項目であり、デフォルト値は 30 分、設定ファイルは ~/Library/Application Support/Headroom/settings.json に保存される。ただし判定はホームフォルダ、/opt/homebrew、/usr/local で実行されるか、テストブラウザ、検索、シェルである場合に限られているため、ほかのパスに残ったプロセスは捕捉できない可能性がある。macOS 専用であり、コミットメッセージの実行例は作者が自分の作ったアプリが動いている Mac における個人的経験としてのみ示されており、別途のベンチマークはない。エージェントを長く 붙잡아 두는 macOS 環境であれば確認する価値のある変更である。