Communitygithub.com

luminik-io/alfred-os

個人開発者向けローカルエージェントOS:launchd管理のClaude Code/Codexフリート、git-worktree分離、Slackレポート、安全ゲート、再現可能なセットアップ。

alfred-os とは?

Alfred OSは、個人開発者が複数のAIエージェント(Claude Code、Codex)をローカルマシン上で効率的かつ安全に管理・運用するためのスキルです。macOSのlaunchdを使用してエージェントフリートを常駐起動させ、git worktreeによるタスクごとの作業ディレクトリ分離、Slackへのレポート送信、そして安全な実行を担保するゲート機能を提供します。これにより、開発者はスケーラブルで再現性のあるエージェント環境を手軽に構築でき、人的ミスやリソース競合を防ぎながら生産性を向上させることができます。主にClaude CodeとCodexに対応しており、設定ファイル(alfred.yaml)による宣言的なセットアップが可能です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add luminik-io/alfred-os

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

alfred-os は何をしますか?

個人開発者向けローカルエージェントOS:launchd管理のClaude Code/Codexフリート、git-worktree分離、Slackレポート、安全ゲート、再現可能なセットアップ。

概要

Alfred OSは、あなたのローカルマシン上でAIエージェントのフリートを調整・管理するためのツールです。macOSのlaunchdを使用してエージェントをデーモンとして実行し、Git worktreeでタスクを分離し、Slackにステータスを報告し、その他多くの便利な機能を提供します。

クイックスタート

# 設定ファイルを作成
cp alfred.example.yaml alfred.yaml
# 設定を編集
nano alfred.yaml
# Alfred OSを起動
./alfred start

設定 (alfred.yaml)

agent_fleet:
  claude_code:
    count: 3
    model: "claude-sonnet-4-20250514"
    memory: "512MB"
  codex:
    count: 2
    model: "gpt-4o"
    memory: "256MB"

isolation:
  worktree: true
  base_path: "/path/to/projects"

reporting:
  slack:
    webhook_url: "https://hooks.slack.com/services/YOUR_WEBHOOK"
    channel: "#agent-updates"
    interval: "5m"

gates:
  rate_limit:
    max_requests_per_minute: 10
  cost_limit:
    max_daily_cost_usd: 5.00

コマンド

コマンド説明
./alfred startエージェントフリートを起動します
./alfred stopすべてのエージェントを停止します
./alfred statusフリートのステータスを表示します
./alfred logsエージェントのログを表示します
./alfred scale --claude 5 --codex 3フリートをスケーリングします
./alfred gate --block安全ゲートをブロックモードにします

安全ゲート

Alfred OSには、以下の安全メカニズムが組み込まれています:

  • レート制限:API呼び出しの頻度を制限します
  • コスト制限:1日あたりのコスト上限を設定します
  • サンドボックス:必要に応じてエージェントを隔離された環境で実行します
  • 監査ログ:すべてのエージェントアクションを記録します

前提条件

  • macOS 12.0+
  • Claude Code または Codex CLI がインストールされていること
  • git 2.30+
  • yq (YAMLプロセッサ、オプション)

アーキテクチャ

+------------------+
| Alfred OS CLI    |
+------------------+
         |
         v
+------------------+    +------------------+
| launchd Manager  | -> | Git Worktree     |
+------------------+    +------------------+
         |                       |
         v                       v
+------------------+    +------------------+
| Agent Fleet      |    | Isolation Layer  |
| (Claude/Codex)   |    +------------------+
+------------------+
         |
         v
+------------------+
| Slack Reporter   |
+------------------+

トラブルシューティング

  • エージェントが起動しない:launchd の権限とパスを確認してください
  • Slackへの報告が機能しない:Webhook URLが正しいことを確認してください
  • worktreeの競合:./alfred stop を実行し、手動でworktreeをクリーンアップしてください

ライセンス

MIT

関連スキル