Feedbacks

フィードバック

無料で使える、Apache-2.0 のビジュアルフィードバック、セッションリプレイ、デバッグコンテキスト。

スクリーンショット、正確なテキストの提案、または動画とセッション録画で問題を示せます。議論、イベントのタイムライン、ブラウザーの診断情報、承認済みのプロジェクトコンテキストを一元管理できます。チームとコーディングエージェントは証拠を調査し、合意した変更を行って、その検証を記録できます。製品全体を無料でセルフホストできます。インフラストラクチャと、使用する AI ツールはご自身で用意してください。

まずチームサーバーをセットアップしてください。 手順は、サーバー → Chrome 拡張機能のインストールと接続 → プロジェクトコンテキスト、任意の GitHub App とメンバーの設定 → 各開発者の個人用 MCP セットアップの順です。1 つのインストールでチーム全体を利用できます。拡張機能はサーバーをホストしません。セットアップの全手順または、個別のDevOps インストールガイドに従ってください。

ウェブサイト · Feedbacks について · セルフホスト · 拡張機能 · コーディングアシスタントとプラグイン · API と MCP · ロードマップ · コントリビューション

できること

• 変更点を正確に示す： スクリーンショットへのピン留め、注釈、ページ全体のキャプチャ、選択したテキストの置換提案。
• バグをリプレイする： 動画またはセッションのみの録画を、アクティビティ、コンソール、ネットワーク、パフォーマンスをまとめた 1 つのタイムラインで確認できます。フレームの保存と注釈にも対応しています。
• 証拠を取りまとめる： 議論、メディア、録画、診断情報、チェックサムを含む完全なスレッドバンドル、範囲を限定したエージェントによる読み取り、録画のエクスポートに対応しています。
• エージェントにコンテキストを提供する： MCP、API、CLI を通じて、承認済みのプロジェクト指示、レビュアー向けガイダンス、担当範囲を提供します。
• 作業を進める： 割り当て、カテゴリ、タグ、保存済みビュー、ポイント進捗を管理できます。複数のリポジトリやインストール環境にまたがる GitHub Issues にも対応し、複数の App を設定して、プロジェクトごとにオーナーが選択した 1 つの App を使用できます。
• 拡張機能以外でもレビューする： 範囲を限定したゲストリンク、PDF／画像のレビュー、任意のテキストウィジェット、アンケート／NPS、スケジュール実行の公開ページ QA、ネイティブモバイルクライアント、署名付き Webhook に対応しています。
• サービス全体を管理する： Apache-2.0 のサーバーとクライアント、PostgreSQL、プライベートな S3 互換ストレージを利用できます。1 つのインストールで 1 つの組織に対応します。

録画ガイド · デバッグバンドル · テキストの提案 · その他のレビューワークフロー

Feedbacks は初期の 0.x リリースです。各アプリケーションのデプロイ環境は 1 つの組織に対応します。一般向け登録、課金、SSO、共有データベースでの顧客テナント管理は実装されていません。アーキテクチャとデプロイの境界をご覧ください。

Docker で試す

curl -fsSL https://feedbacks.softinator.ai/install.sh | bash

生成されたオーナー用ログイン情報で http://localhost:3000 を開いてください。PostgreSQL とスクリーンショットは Docker ボリュームに保存されるため、S3 アカウントやソースのビルドは不要です。インストーラーには Docker Compose、Bash、curl、OpenSSL が必要です。また、既存のインストールディレクトリは保持されます。クイックスタートと本番環境向けガイドをご覧ください。

ソースから開発する

必要なもの：Node.js 22 または 24、npm、PostgreSQL 用の Docker Compose。

git clone https://github.com/Softinator-TechLabs/feedbacks-oss.git
cd feedbacks-oss
npm ci
cp .env.example .env
docker compose -f compose.dev.yaml up -d --wait
npm run bootstrap
npm run build
npm run dev:server

ブートストラップの前に、ローカルの .env に BOOTSTRAP_EMAIL、BOOTSTRAP_NAME、一意の BOOTSTRAP_PASSWORD を追加してください。ブートストラップで最初のオーナーが一度だけ作成されます。その後、ブートストラップ用パスワードを削除してください。localhost:3000 を開きます。データベースパスワードの例は、ループバックのみでアクセスできる開発用データベースのものです。

クライアントの編集内容をリアルタイムに反映するには、別のターミナルで npm run dev:web を実行し、サーバーを再起動する前に .env で APP_ORIGIN=http://localhost:5173 を設定してください。ブラウザーではそのオリジンを使用します。スタンドアロンの公開ウェブサイトには、npm run dev:site を使用してください。

本番環境には HTTPS、PostgreSQL、非公開の S3 互換ストレージが必要です。設定、最初のオーナーのセットアップ、復旧については、デプロイガイドに従ってください。

レジストリにデプロイする場合は、Docker Hub の公開イメージとレジストリ用 Composeを使用してください。図解付きストレージガイドでは、5 つの前提条件とそれに対応する環境フィールドを説明しています。開発者は、バンドルされたClaude Code と Codex のプラグインを 2 つのコマンドでインストールし、独自のスコープ付きキーを接続できます。

プラグインディレクトリの状況

確認日：2026年10月21日。Claude Code と Codex への直接インストールは、公開マーケットプレイスから利用できます。

公式ディレクトリ	現在の状況
Claude Code	バージョン 0.2.2 はセキュリティスキャンに合格しました。公開を申請済みで、Anthropic のレビュアーによる審査待ちです。公式ディレクトリにはまだ掲載されていません。
OpenAI	ローカルのコマンド／stdio MCP の申請アクセスは、OpenAI の審査待ちです。このパッケージの公式ディレクトリへの申請と公開は、まだ利用できません。

これらの審査について、公開日の確定情報はありません。今すぐ直接インストールの手順を使用してください。ディレクトリの状況は、セルフホスト可能な Apache-2.0 製品には影響しません。エージェントのセットアップと配布範囲を参照してください。

ブラウザー拡張機能

npm run build:extension でビルドします。Chrome の Load unpacked から dist/extension/unpacked/ ディレクトリを読み込むか、dist/extension/ にある ZIP を使用してください。ご自身の Feedbacks サーバーアドレスを入力し、ウェブアプリケーションでペアリングを承認してください。ウェブサイト全体への権限付与は、別途任意で行えます。既存の保存済みサーバー接続は引き続き利用できます。

リポジトリの構成

パス	役割
src/server/	認証、プロジェクトへのアクセス、ビジネス処理、永続化、トランスポート
src/shared/	型付きの操作入力、出力、説明
src/web/	認証済みの React アプリケーション
src/cli/	ブートストラップ、JSON CLI、stdio MCP アダプター
plugins/	Codex および Claude Code のプラグインパッケージとレビュー用スキル。MCP バンドルはビルド時に生成されます
extension/	Chrome Manifest V3 のキャプチャおよびレビュー用拡張機能
site/	独立してデプロイ可能な公開ウェブサイト
tests/	分離された認可、トランスポート、データベースのテスト
ops/	汎用デプロイ設定
docs/	コントリビューターおよび運用担当者向けの公開ドキュメント

エージェントの開発

まず AGENTS.md とドキュメントマップを確認してください。Claude Code と Gemini CLI には、同じ手順を参照する簡易アダプターがあります。対応しているスキルとクライアントの設定を参照してください。デプロイ用の認証情報を使わず、合成データを使用する独立したアプリを実行するには、次のコマンドを使います。

npm ci
npm run harness:dev

このコマンドはアプリをビルドし、ループバック URL と非公開のローカルアクセスファイルのパスを出力します。実行ごとに破棄可能なデータベースと独立したポートが用意されます。

開発

npm run check
# Optional native PostgreSQL concurrency tests (initdb and pg_ctl on PATH):
npm run test:postgres

check は、フォーマット、アーキテクチャとドキュメントのチェック、型チェック、テスト、すべてのビルド、分離されたアプリのスモークチェック、リリースコンテンツのチェックを実行します。CI では、ネイティブ PostgreSQL テスト、依存関係の監査、シークレットスキャンも実行されます。ビルドが成功しても、本番環境へのデプロイや十分な処理能力を示すものではありません。

ライセンスとコミュニティ

アプリケーション、拡張機能、ウェブサイトのソースコードはApache-2.0 ライセンスの下で公開されています。依存関係にはそれぞれのライセンスが適用されます。コントリビューションガイドライン、コミュニティ規範、セキュリティ報告、商標に関するガイダンスをお読みください。