画面録画、コンソールログ、ネットワークログ付きの GitHub Issues バグ報告
更新日
GitHub Issues は、多くのプロダクトチームやオープンソースプロジェクトが、コードのすぐ隣でバグを管理している場所です。Midge なら、チームの誰でもバグを録画し、コンソールログ、ネットワークリクエスト、デバイス情報と一緒に記録できます。あとは Send to GitHub をクリックするだけで、AI が書いた要約、再現手順、考えられる原因、録画へのリンクを含む Issue が作成されます。
使い方
- アプリを一度インストールする。 ワークスペースの管理者が Midge で Settings › Workspace › Integrations を開き、GitHub の Connect をクリックします。GitHub から Midge Bug Reports アプリのインストールと、Issue を作成できるリポジトリの選択を求められます。Midge は管理者の GitHub サインインで、そのインストールが本人のものであることを確認してから保存します。その後、バグを登録するリポジトリを選びます。
- バグを録画する。 Chrome 拡張機能、Midge for Mac、Midge for iPhone のいずれかで、画面を録画するかスクリーンショットを撮ります。レポートには、コンソール、ネットワークリクエスト、クリック、デバイスの詳細が記録されます。
- GitHub に送る。 レポート上で Send to GitHub をクリックします。アプリが Issue を作成し、レポートには作成された Issue が表示されます。
GitHub の Issue に入る内容
GitHub は Markdown を表示できるので、Issue はほかに何も開かなくても読める形になります。
- 動画、コンソール、ネットワークのパネルがある Midge のレポートへのリンク
- AI 要約
- 録画での操作から作られた、番号付きの再現手順
- 考えられる原因
- ページの URL と、コンソールエラーおよび失敗したリクエストの件数
最後には、要約がマスキング済みのログから AI によって書かれたことが明記されます。
まず報告者の言葉を
期待していた結果や使ったアカウントなど、報告者がレポート送信時に入力した内容は、Issue のリンクのすぐ下、AI 要約より前に入ります。バグを実際に見た人の言葉が最初に来て、書かれなかった部分を要約が補います。
必要最小限の権限
Midge Bug Reports アプリが求めるのは、選んだリポジトリに対する issues: write と metadata: read だけで、それ以外は何も求めません。コード、プルリクエスト、Actions は読めません。リポジトリを外したり、アプリをアンインストールしたりは、GitHub の設定からいつでもできます。
機密情報をリポジトリに入れない
パブリックリポジトリでは、Issue の本文も公開されます。Midge はパスワード、トークン、Cookie、Authorization ヘッダー、カード番号を、ブラウザやスマートフォンから送信される前にログから取り除き、メールアドレスと電話番号をマスクします。Issue はそのマスキング済みのログから書かれます。録画そのものは独自の共有設定とともに Midge に残ります。「Workspace members」か「Only me」にしておけば、Issue が公開されていても録画は非公開のままです。詳しくはマスキングをご覧ください。
Issue から修正まで
開発者は Issue を開き、録画へのリンクをクリックして、バグが起きた瞬間の失敗したリクエストとスタックトレースを確認します。コーディングエージェントを使っているなら、同じリンクを Claude Code や Cursor に貼れば、エージェントが Midge の MCP サーバー経由でコンソール、ネットワークリクエスト、操作手順を読み取ります。
使っているチーム
- すべてを GitHub で管理していて、バグのためだけに別のツールを増やしたくない小規模なプロダクトチーム。
- エンジニアがすでに見ているリポジトリにバグを登録する QA とサポート。
- 「動きません」だけの Issue ではなく、ログ付きの報告がほしいメンテナー。
連携機能を使わない場合
どのレポートにもリンクがあり、作成したときにコピーされます。Issue、プルリクエスト、Discussion のどこに貼っても、同じレポートが開きます。
関連ページ
Midge は GitHub 連携も含めて無料です。録画数は無制限、動画は最長 15 分、透かしも入りません。
よくある質問
- Midge の GitHub App にはどんな権限がありますか?
- インストール時に選んだリポジトリに対する、Issues の書き込み(write)とメタデータの読み取り(read)だけです。コードを読んだり変更したりはできません。
- Issue の作成者として誰が表示されますか?
- Midge Bug Reports アプリです。Issue には Midge のレポートへのリンクがあり、そこで誰が録画したかがわかります。
- プライベートリポジトリでも使えますか?
- はい。アプリがインストールされているリポジトリならどれでも使えます。Issue はレポートへのリンクを含むので、適切な人が開けるようにレポートの共有設定を確認してください。
- GitHub Enterprise Server や GitLab には対応していますか?
- 対応していません。GitHub.com だけです。ほかのツールには、署名付き Webhook と自社の小さなサービスを使えば Issue を作成できます。