runvouch

RunVouch

無人で稼働する AI エージェントを見守るウォッチドッグです。タスクを完了した証拠を提示し、完了しなかった場合やコストが発生し始めた場合には即座に通知します。実行ごとに改ざんを検知できる証明を残します。
Claude Code Routines · ヘッドレス claude -p · OpenClaw · n8n · cron

ウェブサイト · ドキュメント · 実行を検証 · フィールドノート · MCP Registry · Product Hunt

実行が緑色で表示されても、スケジューラーが動作したことを示すだけで、タスクが完了したとは限りません。スケジュールされたエージェントが見つからない、失敗した、ループしている、予算超過した、動作が逸脱している、または証拠なしで成功を報告した場合、RunVouch は数分以内に通知します。

pip install runvouch     # or: npm install -g runvouch  (zero-dependency client + rv CLI)
rv agent nightly-report --cadence 24h --cap-run-cost 2 --evidence
rv run nightly-report --evidence-file out/report.html -- claude -p "build tonight's report"

クライアントもヘッダーも不要です。すべてのエージェントには ping URL も用意されているため、URL を呼び出せるものであれば何でも報告できます。

0 3 * * * /usr/local/bin/nightly.sh; curl -fsS -m 10 https://api.runvouch.com/ping/<token>/$?

成功時は何も不要です。/start で実行を開始し、/fail または終了コードで失敗を報告します。rv agent NAME で URL を表示できます。

検証可能な実行

完了した実行ごとに sha256 レコードが作成され、UTC の日ごとに、前日のルートと連結された Merkle ルートが作成され、OpenTimestamps で Bitcoin にタイムスタンプが付与されます。日次ファイルは https://api.runvouch.com/proof/ で公開されており、templates/verify_proof.py（標準ライブラリのみ）を使えば、こちらのコードを使わずに証明を検証できます。Free を含むすべてのプランで利用できます。

rv proof RUN_ID --verify     # recomputes leaf + Merkle path against the public day file, exit 0 or 1

アカウントなしで自分で確認できます： https://runvouch.com/verify では、RunVouch 自身のフリートから実際に封印された実行を 1 件受け取り、ブラウザー内ですべてのハッシュを再計算できます。また、フィールドを編集して証明が壊れる様子を確認できるボタンもあります。

仕組みと制限：https://runvouch.com/docs/proof · 必要とする人について：https://runvouch.com/verifiable-agent-runs

検知機能

アラート	意味
MISSED	予定されていた実行が開始されませんでした（スケジューラー停止、認証の有効期限切れ、最初の行を実行する前のクラッシュ）
FAILED	実行が 0 以外の終了コードで終了／status=fail
NO_EVIDENCE	実行は ok と報告しましたが、必要な証拠（ファイルの書き込み、URL 200、アサーション）がありません。緑色 ≠ 完了
RETRY_STORM	1 回の実行中に、同じツールへ同一入力で N 回以上アクセスしています（見えないループによって $437 のコストが発生）
BUDGET_RUN / BUDGET_DAY	設定した上限をコストまたはトークンが超過しました。Solo と Team ではエージェントが一時停止し、rv agent NAME --resume を実行するまで次の実行は拒否されます
DRIFT	実行時間／出力サイズが過去 7 回のベースライン（ロバスト MAD）から逸脱しており、気付かないうちに別の動作をしています
STALLED	開始後、最大実行時間を過ぎても終了せず、ハートビートもありません

アラートは、メール、Telegram、Slack、任意の JSON webhook、PagerDuty（Team）、およびダッシュボードに送信されます。

構成

runvouch/server.py            FastAPI + SQLite, all detectors, dashboard at /
runvouch/cli.py               `rv`, stdlib-only client: rv agent / rv run -- CMD / rv status / rv alerts / rv proof
integrations/claude-code-plugin Claude Code plugin: SessionStart/PostToolUse/Stop hooks → RunVouch
integrations/mcp                MCP server (stdio): runvouch_status/alerts/ack/runs/run_start/run_end
site/build.py                   generates the site into site/public/ (served by the same server)
tests/                          123 tests (pytest, no network)
docs/SELF_HOSTING.md            run it yourself: Docker or venv, what differs from hosted

セルフホスト

1 つのプロセスと 1 つの SQLite ファイルで動作し、Docker または venv で実行できます。詳しくは docs/SELF_HOSTING.md をご覧ください（所要時間 10 分。ホスト型サービスとの違いや、後から移行する方法も説明しています）。

cp .env.example .env && docker compose up -d          # or: pip install -r requirements.txt && ./run.sh
curl -X POST "localhost:8787/admin/accounts?name=me&plan=team" -H "X-Admin-Token: $RUNVOUCH_ADMIN_TOKEN"   # -> api_key

使い方

export RUNVOUCH_KEY=rv_... RUNVOUCH_URL=http://localhost:8787
rv agent nightly-report --cadence 24h --cap-run-cost 2 --evidence
rv run nightly-report --evidence-file out/report.html -- claude -p "build tonight's report"
rv status ; rv alerts

Claude Code プラグインについては、integrations/claude-code-plugin/README.md をご覧ください。 MCP：claude mcp add runvouch -e RUNVOUCH_KEY=... -- python3 integrations/mcp/runvouch_mcp.py

テストとコントリビュート

.venv/bin/pip install -r requirements-dev.txt && .venv/bin/python -m pytest -q tests

CONTRIBUTING.mdを参照してください。

ホステッド版とセルフホスト版

runvouch.comでホステッド版を提供しています。3つのエージェントまでは無料、Soloは19ドル、Teamは99ドルです。アラート、ダッシュボード、サーバー上での毎晩のデータベースバックアップ、EUでのホスティングを利用できます。セルフホスト版はこのリポジトリで提供しており、MITライセンスです。コードは同じです。

比較

Healthchecks.ioとの比較 · Cronitorとの比較 · Langfuseとの比較

ライセンス

MIT。