CLANG-INCLUDE-FIXER(1)

💖 CLANG-INCLUDE-FIXER 💖

okay so bestie, meet clang-include-fixer — it's the User Commands girlie from the CLANG-INCLUDE-FIXER(1) man page, and she's here to fix your includes. periodt.

---

✨ DESCRIPTION ✨

The vibe check first, the whole usage in one glorious line:

USAGE: clang-include-fixer [options] <source0> [... <sourceN>]

Then it says, very iconically:

OPTIONS:

---

🌈 Generic Options 🌈

These are the standard-issue ones every cool tool gets, no cap:

• --help — shows you all the available options. and if you want the secret menu, add --help-hidden for more 💅
• --help-list — prints the list of available options. same deal: --help-list-hidden gives you more 👑
• --version — tells you which version of this program you're running. slay.

---

🎀 Tool options 🎀

the main character section, fr fr:

• --db=<value> — picks your input format. the options are:
  • =fixed — a hard-coded mapping 🔥
  • =yaml — a YAML database, as created by find-all-symbols
  • =fuzzyYaml — a YAML database, but with fuzzy-matched names ✨
• --extra-arg=<string> — one more argument to append to the compiler command line 🫶
• --extra-arg-before=<string> — one more argument to prepend to the compiler command line (yes, before. order matters bestie)
• --input=<string> — a string used to initialize the database
• --insert-header=<string> — inserts a specific header. 🚨 this one has to run in STDIN mode. the result goes to stdout, and it's currently used for editor integration. it supports YAML/JSON format, like this:

-insert-header="{
    FilePath: "/path/to/foo.cc", QuerySymbolInfos: [
    {RawIdentifier: foo,
        Range: {Offset: 0, Length: 3}}
    ],     HeaderInfos: [ {Headers: "\"foo_a.h\"",
        QualifiedName: "a::foo"} ]}"

• --minimize-paths — whether to minimize the added include paths. lowkey tidy ✨
• --output-headers — prints the symbol being queried and all its relevant headers as JSON to stdout. it's giving very readable:

{
  "FilePath": "/path/to/foo.cc", "QuerySymbolInfos": [
  {"RawIdentifier": "foo",
      "Range": {"Offset": 0, "Length": 3}}
  ],     "HeaderInfos": [ {"Header": "\"foo_a.h\"",
      "QualifiedName": "a::foo"} ]
}

• -p <string> — the build path 🛠️
• -q — reduces terminal output. quiet queen energy 💀
• --query-symbol=<string> — queries a given symbol (like "a::b::foo") in the database directly, without parsing the file. so efficient 💅
• --stdin — overrides the source file's content (in the overlaying virtual file system) with input from <stdin>, then runs the tool on that new content using the compilation options of the source file. this mode is currently used for editor integration 👑
• --style=<string> — the fallback style used for reformatting after inserting new headers, in case there's no clang-format config file found 🌸

---

💖 reminder bestie: the STDIN modes (--insert-header especially) are the ones your editor is probably calling behind your back. that's not a bug, that's a feature.

---

and that's the whole page, literally. this was clang-include-fixer 20, dated September 2026 💜 go fix those includes, you absolute icon 🦋✨🎀