Show HN: Corral – エージェントが起動したすべてのコマンドを終了させる
Show HN: Corral – Kill every command your agent starts (github.com)
要約
Corralは、AIエージェントがバックグラウンドで起動し、終了時にクリーンアップされないコマンドの問題を解決するために開発されたツールです。このツールは、エージェントが開始したプロセスツリー全体を確実に終了させることを目指しています。
全文翻訳
この夏、AIエージェントのバックエンドでインターンシップをしていた際に、tail -fのようなコマンドやランダムなバックグラウンドジョブを実行したまま、それらを終了せずにエージェントが終了してしまうことに気づきました。興味を持ってClaude Codeがどのようにこれを処理しているか調べたところ、同様の問題があることがわかりました。
Bashツールからのバックグラウンドプロセスがセッション終了時にクリーンアップされない問題や、タイムアウトがプロセスグループ全体にSIGTERMを送信してClaude Code自体を終了させてしまう問題があります。ほとんどのランナーは、自身が開始したプロセスのみを終了するため、二重にフォークしたり、バックグラウンドで実行したり、stdoutを開いたままにしたりするものは、生き残るか、ランナーをハングアップさせます。
Corralは、この問題に対する修正を試みる中で、Linuxのプロセスとシグナルについて学ぶための私の試みでした。corral --wall 30s -- yourcommandのように実行すると、完了時には、それが開始したものは何も実行されていないはずです。
コマンドは独自のセッションを持つため、それを終了してもあなた自身を終了させることはできません。また、独自のcgroup内で実行されるモードがあり、プロセスツリー全体が一度に終了するため、セッションやプロセスグループを変更したプロセスも含まれます。
cgroupが利用できない場合は、代わりに/procを通じてツリーを追跡します(これは少し弱く、親プロセスが死んだ後にセッションを変更したプロセスは捕捉できますが、別のユーザーとして実行されているものや、systemdのような別のサービスに引き渡されたものは終了できません)。そして、すべてが終了したことを確認できない場合は、120で終了します。
フィードバックや、さらに学習するために私ができることについて、ぜひご意見をお聞かせください。