open-investigation

Index and serve local Firefox bug investigations via a Python launcher.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/alastor0325/fx-bug-toolkit --skill open-investigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: open-investigation
Source: https://github.com/alastor0325/fx-bug-toolkit/tree/main/skills/open-investigation
Command: npx skills add https://github.com/alastor0325/fx-bug-toolkit --skill open-investigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Open-investigation provides a fast, filterable local viewer for Firefox bug investigations stored across folders, enabling quick discovery, indexing, and viewing of investigation data.

Core Features & Use Cases

  • Build and refresh a searchable index of all investigation files.
  • Serve a local web UI on localhost to browse and open investigations.
  • Retrieve the URL automatically and allow cross-platform launching for quick review.

Quick Start

Run the serve.py launcher to build the index and start the local investigations viewer.

Frequently Asked Questions about open-investigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I view local Firefox bug investigation files scattered across folders?

You can view local Firefox bug investigation files by running a Python-based launcher that builds a searchable index and serves a local web UI on localhost. This viewer reads the FX_BUG_INVESTIGATION_DIR environment variable, defaulting to ~/.fx-bug-toolkit/bug-investigation, to locate your data.

What is the best way to index and browse local bug investigation data?

The best way to index bug investigation data is using a local viewer that builds a filterable index of your files. It serves a private web UI on localhost, allowing you to quickly search, retrieve, and open investigations across scattered folders.

How do I start a local viewer for my bug investigation files?

To start the local viewer, run the serve.py launcher, which automatically builds the index, binds to localhost for a private session, and retrieves the URL for cross-platform launching. This allows you to quickly review your investigation data.

Does the local bug investigation viewer require a specific directory structure?

The viewer does not mandate a rigid directory structure but expects investigation files within the path defined by the FX_BUG_INVESTIGATION_DIR environment variable. If unset, it defaults to ~/.fx-bug-toolkit/bug-investigation to locate your data.

Can I use this local viewer to share my bug investigation index with my team?

No, this local viewer is designed for private sessions and binds specifically to localhost. It targets individual developers and reviewers who need a reproducible, local environment to explore Firefox bug investigations quickly.

Why does my local bug investigation viewer return an empty index?

The viewer returns an empty index if it cannot find investigation files in the configured directory. Ensure your files are stored in the location specified by the FX_BUG_INVESTIGATION_DIR environment variable or the default ~/.fx-bug-toolkit/bug-investigation directory.