kunchenguid/gnhf

何を解決するか

gnhf（Good Night, Have Fun）は、ユーザーが離れている間もAIコーディングエージェントを自動的に継続実行する自律型オーケストレーターです。手動での監視の問題を解決し、特定の目標に向かって小さな、コミット済みで文書化された変更のループを自動化することで、ユーザーが目を覚ましたときに停止したプロセスではなく、クリーンで段階的な作業が完了したブランチに目を向けることができるようになります。

動作方法

このツールは、非対話型のコーディングエージェントを呼び出すループとして動作します。各イテレーションでは以下の手順を実行します：

1. 実行：エージェントに変更を実行させる。
2. 検証：変更が成功した場合、別々のgitコミットを作成し、notes.mdファイルにメモを追加して、イテレーション間で共有メモリを維持する。
3. 失敗処理：イテレーションが失敗した場合、git reset --hardで変更をロールバックするが、コミット失敗の場合は次のイテレーションで修復できるように作業を保持する。
4. 永続化：.gnhf/runs/ディレクトリを使用して、プロンプト、ログ、メタデータを保存し、後から実行を再開できるようにする。
5. レート制限管理：Claudeなどからのレート制限を自動検出し、リセット時間を待ってから実行を再開する。

対象ユーザー

AIコーディングエージェントを使用し、リファクタリングや機能実装など長時間実行が必要なタスクを、手動で各ステップをトリガーしたり、リアルタイムで変更を確認したりせずに実行したい開発者。

特徴

• 段階的コミット：すべての成功したステップが個別にコミットされ、簡単にチェリーピッキングやロールバックが可能。
• エージェント非依存：さまざまなコーディングエージェントCLIおよびACPターゲットと互換性がある。
• ワークツリーモード：同一リポジトリ上で複数のエージェントを隔離されたgitワークツリーを使って同時に実行可能。
• 実行時間制限：最大イテレーション数、合計トークン数、カスタム停止条件（--stop-when）を設定可能。
• リアルタイムステータス：トークン合計数とコミット数をリアルタイムでターミナルタイトルに更新。