Ventrox

コーディングエージェントは一日に何度も同じ壁にぶつかるが、誰もそれを見ない。 Ventrox はエージェントに1つのツール呼び出しを追加する。何を試したか、何が失敗したか、失った分数。 エージェントは vent を読み戻すことはできない。サーバーはそれぞれの vent にセッション、プロジェクト、ブランチ、時刻を刻印する。 レビューアは VENTROX_SECRET=$(ventrox grant) claude でセッションを開始し、おおまかな類似性によってグループ化された vent を、件数と失った分数の順に一覧表示する。 最も多くの分数を失わせた壁が最初に来る。 わずか数百行の Python、ホームディレクトリにある1つの SQLite ファイル、インストールは2つのコマンドだけ。 ネットワークに出ていくものは何もなく、リポジトリに入るものもまだない。 クラスタリングは n-gram に対する TF-IDF で、同義語は見落としがちです。難読化（ redaction ）は正規表現リストによるベストエフォートです。 制限: セッションあたり20件の vent、10分あたり5件の vent。 このアイデアは Lovable の vent tool と vent-widget に由来します。

インストール

Ventrox をグローバルツールとしてインストールします:

uv tool install git+https://github.com/Vetrox/ventrox.git

または, クローンしてチェックアウト先からインストールします:

git clone https://github.com/Vetrox/ventrox && cd ventrox && uv tool install .

次に setup を実行します:

ventrox setup

setup は ventrox-report と ventrox-report のスキルを ~/.claude/skills/ にコピーします。 そして、以下のコマンドで MCP サーバーを登録します: claude mcp add --scope user ventrox -- ventrox

Related MCP server: mcp-chest-memory

利用

レポーター: エージェントは ventrox_vent を tried、failed、minutes_lost を伴っなって呼び出します。 同じ障害が繰り返された場合（2回以上の失敗、または10分以上を経過した場合）に限り、1ターンにつき1件の vent を書き込みます。 同じセッション内では ventrox_edit で vent を修正できます。 サーバーは1セッションにつき20件、10分後につき5件の vent を受け付けます。

レビューア: セッションを単回使用トークンで開始します:

VENTROX_SECRET=$(ventrox grant) claude

トークンは単回使用で、有効期間は10分です。 このセッションにはレビューア用ツールが保持されます。それらのツールを次の順に呼び出してください:

1. ventrox_recluster は、未解決の vent を語彙の重なりによってグループ化します。

2. ventrox_clusters は、未解決件数、次に失った分数の順にグループを並べて一覧表示します。

3. ventrox_resolve_cluster は、グループを resolved または wontfix としてマークします。

アンインストール

ventrox setup --remove
uv tool uninstall ventrox
rm -r ~/.local/share/ventrox   # deletes all vents

ツール

テキストフィールドは1〜4000文字設定可能です。minutes_lost は0〜1440の範囲です。

環境変数

データの場所

サーバーは、$VENTROX_HOME、$XDG_DATA_HOME/ventrox、~/.local/share/ventrox の順に最初のディレクトリを選択します。 すべての vent はそのディレクトリ内の vents.db に置かれます。 ファイルは暗号化されていない平文頻の SQLite です。保護するのはファイルの権限のみです。 データディレクトリが git worktree 内部にある場合、サーバーは起動を拒否し、終了コード 2 で終了します。

スキル

• ventrox-report は、どのような質問が vent として定義されるのか、また3つのフィールドに何を含める必要があるのかをエージェントにオウニ伝えます。

• ventrox-review は、レビューアに reclusters、clusters、resolve をこの順に実行するよう指示します。

• ventrox setup はその両方をインストールします。

プロジェクトの例

プロジェクト固有の良い vent の例を追加するには、プロジェクトのルートに .ventrox.md ファイルを置きます。 VENTROX_EXAMPLES をファイル・パスに設定すると、すべてのプロジェクトに例を追加できます。 サーバーはその両方を ventrox_vent ツールの説明に追加します。

開発

uv sync
uv run pytest
uv run ventrox

非目標

Ventrox はイシュートラッカーには同期しません。 マルチユーザーモードはありません。 ツール呼び出しトレースは記録せず、エージェントが記入した3つのフィールドだけを記録します。 ネットワーク接続を開くことはありません。