herobrine

スケジュール実行される自律エージェント

Claude Code を自動で実行します。スケジュールに従って任意のプロンプトを実行するエージェントを作成できます。朝のブリーフィング、夜間ビルド、定期的な調査などを、Beeper に直接届けます。

Claude Code は対話型で使うだけではありません。デーモンとしても動作します。

---

仕組み

┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│  /herobrine │────▶│  macOS       │────▶│  claude -p      │
│  create          │     │  launchd     │     │  (headless)     │
└─────────────────┘     └──────────────┘     └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │  Deliver via     │
                                              │  Beeper + notif  │
                                              └─────────────────┘

1. エージェントを定義します。名前、プロンプト、スケジュールを指定します
2. 指定時刻に起動する macOS launchd plist が作成されます
3. ランナーが claude -p を --dangerously-skip-permissions（完全自律モード）付きで実行します
4. 結果が Beeper のチャットに送信され、ローカルログにも保存されます
5. 完了すると macOS の通知で確認できます

---

セットアップ

1. スクリプトをインストールする

ランナーとマネージャーのスクリプトを ~/.claude/agents/ にコピーします。

mkdir -p ~/.claude/agents/schedules ~/.claude/agents/logs
cp scripts/run-agent.sh ~/.claude/agents/run-agent.sh
cp scripts/manage-agent.sh ~/.claude/agents/manage-agent.sh
chmod +x ~/.claude/agents/run-agent.sh ~/.claude/agents/manage-agent.sh

2. Beeper への配信を設定する（任意）

Beeper の「Note to Self」チャット ID を確認し、manage-agent.sh のデフォルトの DELIVERY_CHAT を更新します。エージェントは実行のたびに、書式設定された Beeper メッセージとして完全な結果を送信します。

Beeper を使わない場合も、結果は ~/.claude/agents/logs/ に保存され、macOS の通知で届けられます。

---

アクション

アクションを決定する

$ARGUMENTS にアクションキーワード（create、list、remove、run-now、logs）が含まれている場合は、それを使用します。含まれていない場合は、AskUserQuestion を使ってユーザーに尋ねます。

• 新しいスケジュール実行エージェントを作成
• スケジュール実行エージェントをすべて一覧表示
• スケジュール実行エージェントを削除
• 今すぐ実行 — エージェントを直ちに起動
• 過去のエージェント実行のログを表示

---

アクション：作成

AskUserQuestion または引数を使って、ユーザーから次の情報を集めます。

1. エージェント名 — 短い識別子。小文字とハイフンを使用します（例：stock-news、nightly-review）
2. プロンプト — Claude に送信する完全なプロンプトです。詳細に記述します。/steve や /gsd:execute-plan などのスキル呼び出しも含められます
3. スケジュール — わかりやすい指定方法：
   • 毎朝 8 時 → 0 8 * * *
   • 毎晩 6 時 → 0 18 * * *
   • 毎時 → every-1h
   • 30 分ごと → every-30m
   • 平日の朝 9 時 → 0 9 * * 1-5
   • カスタムの cron または間隔
4. モデル — opus、sonnet（デフォルト）、または haiku
5. 最大ターン数 — デフォルト：50

次に実行します。

bash ~/.claude/agents/manage-agent.sh create "<name>" "<prompt>" "<schedule>" "$HOME" "<model>" <max_turns>

アクション：一覧表示

bash ~/.claude/agents/manage-agent.sh list

アクション：削除

エージェント名が指定されていない場合は、まず一覧表示してから、どれを削除するか尋ねます。

bash ~/.claude/agents/manage-agent.sh remove "<name>"

アクション：今すぐ実行

bash ~/.claude/agents/manage-agent.sh run-now "<name>"

アクション：ログ

bash ~/.claude/agents/manage-agent.sh logs [agent-name]

---

使用例

エージェント	プロンプト	スケジュール
stock-news	今日の株式市場の主な動きとテクノロジー企業の決算を調査します。最も重要な 5 件を要約します。	0 8 * * 1-5
pr-digest	my-org/my-repo の未クローズの PR をすべて確認します。変更を要約し、懸念点を挙げ、必要な承認を記載します。	0 9 * * 1-5
overnight-build	/steve を使って /path/to/project の次のフェーズを実装します	0 2 * * *
security-scan	/path/to/repo を OWASP Top 10 の脆弱性について監査します。深刻度を添えて調査結果を報告します。	0 6 * * 1
dep-updater	/path/to/project の古い依存関係を確認します。安全な更新を含む PR を作成します。	0 3 * * 0

---

ファイル構成

~/.claude/agents/
├── run-agent.sh              # Executes claude -p, delivers results
├── manage-agent.sh           # Create/list/remove/run-now/logs
├── schedules/                # Agent configs (JSON)
│   └── stock-news.json
└── logs/                     # Execution logs
    ├── stock-news_20260211_080000.log
    └── stock-news_launchd.log

~/Library/LaunchAgents/
└── com.claude.agent.stock-news.plist   # macOS scheduler

---

主な詳細

• エージェントは --dangerously-skip-permissions 付きで実行されます。完全自律型で、確認プロンプトは表示されません
• スケジュールを確実に実行できるよう、各エージェントに専用の launchd plist が割り当てられます
• Beeper への配信指示はプロンプトに挿入されるため、起動した Claude インスタンスが MCP 経由で自ら配信します
• ログには、各実行の完全な出力がタイムスタンプ付きで記録されます
• エージェントはほかのスキル（/steve、/rnv、/gsd:execute-plan）を呼び出せます。完全な Claude Code インスタンスとして動作します