vibe-loop は何をしますか？
制限付きAIコーディングエージェントループのためのCLIスーパーバイザー。プラグイン可能なタスクソース、ロック、ログ、再利用可能なワークフロースキルを備えています。
概要
vibe-loopは、AIコーディングエージェント（例：Claude Code、Cursor、Codex）のループ実行を監督・管理するコマンドラインツールです。エージェントが無限ループに陥るのを防ぐために、最大反復回数やタイムアウトなどの境界を設定できます。
特徴
- 制限付きループ: エージェントの実行回数や時間に上限を設定
- プラグイン可能なタスクソース: ファイル、標準入力、その他のソースからタスクを動的に読み込み
- ロック機構: 複数のエージェントインスタンス間での排他制御を実現
- 詳細なログ: 各ループの実行履歴を記録し、デバッグや監査に活用
- 再利用可能なワークフロースキル: 定義したループ設定をスキルとしてエクスポートし、他のプロジェクトで再利用
インストール
pip install vibe-loop
または、ソースからインストール:
git clone https://github.com/ei-grad/vibe-loop.git
cd vibe-loop
pip install -e .
使い方
基本的な使用例:
vibe-loop --max-iterations 10 --task-file tasks.txt
環境変数による設定:
export VIBE_LOOP_MAX_ITERATIONS=5
export VIBE_LOOP_TASK_SOURCE=stdin
vibe-loop
タスクソース
--task-sourceオプションでタスクの読み込み元を指定:
file: 指定したファイルからタスクを読み込む (--task-file)stdin: 標準入力からタスクを読み込む- カスタムプラグイン: 独自のタスクソースを実装可能
ロック
並行実行を防ぐためにロックを使用:
vibe-loop --lock-file /tmp/vibe.lock
ログ
ログはデフォルトで~/.vibe-loop/logs/に保存されます。
スキルとしての使用
vibe-loopは、他のAIエージェントのスキルとして組み込むことができます。SKILL.mdファイルに以下のように記述します:
name: vibe-loop
version: 1.0.0
description: 制限付きAIコーディングエージェントループ
author: ei-grad
ライセンス
MIT
貢献
バグ報告や機能リクエストは、GitHub Issues までお願いします。