FIREBUILD(1)

💖 FIREBUILD(1) 💖

okay bestie, welcome to the firebuild era — this is a User Commands girly and she's here to make your builds go zoom 🌈✨

---

✨ NAME ✨

firebuild — accelerate build 🚀💅

---

🌸 SYNOPSIS 🌸

firebuild [OPTIONS] {BUILD COMMAND}

---

🦋 DESCRIPTION 🦋

Execute BUILD COMMAND with Firebuild instrumentation. that's it, that's the whole vibe. she wraps around your build command and does her lil magic 🪄

---

🎀 OPTIONS 🎀

the mandatory arguments to long options are mandatory for short options too, no cap. fr fr. 🙈

• -c, --config-file=FILE — use FILE as configuration file 🌸
• -C, --directory=DIR — change directory before running the command. yes she's doing a lil cd first, iconic behavior 👑
• -d, --debug-flags=list — comma separated list of debug flags. pro tip: -d help to get a list. (that's literally in the docs bestie, go ask her) 💀
• -D, --debug-filter=list — comma separated list of commands to debug. debug messages related to processes which are not listed are suppressed. so like... only the listed ones get the spotlight, main character energy only ✨
• -g, --gc — garbage collect the cache. keeps debugging entries related to kept files when used together with --debug cache. spring cleaning but make it cache 🧹
• -r, --generate-report=[HTML] — generate a report on the build command execution. the report's filename can be specified (firebuild-build-report.html by default). receipts!! 📄💖
• -h, --help — show this help. your girl is so helpful 🫶
• -o, --option=key=val — add or replace a scalar in the config
• -o, --option=key=[] — clear an array in the config
• -o, --option=key+=val — append to an array of scalars in the config
• -o, --option=key-=val — remove from an array of scalars in the config

bestie note: yep, that's four whole things all riding on the same -o, --option flag. she contains multitudes 💅

• -q, --quiet — quiet; print error messages only from firebuild. the BUILD COMMAND's messages are not affected. so your build can still be as loud as it wants, she's just not gonna add to the noise 🤫
• -s, --show-stats — show cache hit statistics. when used together with BUILD COMMAND, the statistics of the current run are shown. without a BUILD COMMAND it shows the cumulative statistics of all prior runs (since the creation of the used cache directory). number go up, we love to see it 📈😭
• -z, --zero-stats — zero cache hit statistics before performing any other action. reset the counter, fresh start, new me 🌱
• -i, --insert-trace-markers — perform open("/FIREBUILD debug message", 0) calls to let users find unintercepted calls using strace or ltrace. this works in debug builds only. 🕵️‍♀️✨ no like seriously, debug builds only, don't come for me if you're on a release build
• --version — output version information and exit. slay, bye 👋

---

💀 EXIT STATUS 💀

Exit status of the BUILD COMMAND or 1 in case of failure in firebuild. so if your build is happy, she's happy. if she's the one who tripped, you get a 1 🫠

---

aaaaand that's the whole page bestie, you ate that 💖🎀🦋

this has been firebuild 0.8.6.1, dated 08/25/2026, straight from the FIREBUILD(1) manual. mwah 💋 go build something iconic ✨👑