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.