MCPcopy Index your code
hub / github.com/Explosion-Scratch/firebuilder

github.com/Explosion-Scratch/firebuilder @v1.0.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.2 ↗ · + Follow
16 symbols 68 edges 33 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Firefox Profile Creator - Build the best firefox in seconds!

<a href="https://github.com/Explosion-Scratch/firebuilder/raw/v1.0.2/img.png">
    <img src="https://github.com/Explosion-Scratch/firebuilder/raw/v1.0.2/img.png" width=800 alt="Demo Image 😁"/>
</a>

The end-all firefox configurator! - See it in action

<hr/>

Basically an interactive CLI program that generates a config.json file which is then processed and built into a Firefox Profile folder.

Features:

  • 🖊️ userChrome: Pick and choose from CSS tweaks
  • ⚙️ user.js: Apply firefox hardening - Sensible defaults are included, intended to leave all functionality but remove tracking
  • ☁️ Install from repos: Basically any git repo you can think of, this supports installing userChrome, user.js, etc, from it (and customizing)
  • Install fx-autoconfig: Install fx-autoconfig for browser .uc.js files.
  • 🔄 Install .uc.js files from repos: See examples/uc.js-scripts for an example.
  • 📈 Extend an existing profile: This tool can copy bookmarks, history, passwords, extensions and cookies from an existing Profile (example)
  • 🫥 Start with defaults (or not): You can start customizing based on sensible defaults or vanilla firefox

Getting started:

Download a binary for your platform from dist or from releases

Shameless plug: You can install this in one command using my tool justinstall by running justinstall explosion-scratch/firebuilder

Or: Run bun cli.js for an interactive setup or see examples. To use a configuration from examples you can run bun cli.js examples/my-config/config.jsonc.

git clone https://github.com/Explosion-Scratch/firebuilder
cd firebuilder
# Or if you want to use my config with no interactivity: bun cli.js examples/my-config/config.jsonc --launch`
bun cli.js

Contributing

  • See CONTRIBUTING.md for details. Basically it's pretty simple, add your thing via a json/js file and make sure it has a handler

Want something added?

Just ask me (in an issue) I'll try to add it or make a PR!

Core symbols most depended-on inside this repo

copyFilesToProfile
called by 18
helpers/copyFilesToProfile.js
readJSON
called by 8
helpers/readJson.js
ensureFolder
called by 4
helpers/ensure.js
confirm
called by 3
cli.js
onExit
called by 2
helpers/onExit.js
run
called by 1
run.js
fmt
called by 1
cli.js
tc
called by 1
cli.js

Shape

Function 16

Languages

TypeScript100%

Modules by API surface

cli.js4 symbols
helpers/ensure.js2 symbols
run.js1 symbols
modules/custom-js/index.js1 symbols
helpers/readJson.js1 symbols
helpers/onExit.js1 symbols
helpers/copyFilesToProfile.js1 symbols
handlers/usercss.js1 symbols
handlers/user.js1 symbols
handlers/repo.js1 symbols
handlers/extensions.js1 symbols
handlers/contentcss.js1 symbols

For agents

$ claude mcp add firebuilder \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact