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 がインストールされていること
git2.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