CLANG-INCLUDE-FIXER(1)

💖 NAME 💖

clang-include-fixer — it's the manual page for clang-include-fixer 17, bestie. Yes, the whole thing. Grab a strawberry 🍓 and let's go.

---

✨ DESCRIPTION ✨

okay so here's the vibe. The usage is literally:

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

and then, and this is the part where you sit up straight:

OPTIONS:

Let's break it down, babes. 💅

🌸 Generic Options 🌸

• --help — shows you the options you can actually use. (Want the hidden ones too? That's --help-hidden. 🙈)
• --help-list — prints a whole list of the available options. (--help-list-hidden if you're feeling nosy about the hidden ones too.)
• --version — tells you what version of this program you're running. Iconic.

👑 Tool options 👑

• --db=<value> — specifies the input format. And the formats are:
  • =fixed — a hard-coded mapping.
  • =yaml — a Yaml database created by find-all-symbols.
  • =fuzzyYaml — a Yaml database, but with fuzzy-matched names. ✨
• --extra-arg=<string> — an additional argument to append to the compiler command line.
• --extra-arg-before=<string> — an additional argument to prepend to the compiler command line.
• --input=<string> — a string to initialize the database with.
• --insert-header=<string> — inserts a specific header. Heads up: this should run with STDIN mode, and the result gets written to stdout. It's currently used for editor integration, and it supports YAML/JSON format, like:

-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 added include paths.
• --output-headers — prints the symbol being queried and all its relevant headers in JSON format to stdout, like:

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

• -p <string> — build path.
• -q — reduces terminal output. (Shy queen behavior. 🎀)
• --query-symbol=<string> — queries a given symbol (e.g. "a::b::foo") in the database directly, without parsing the file. no cap.
• --stdin — overrides the source file's content (in the overlaying virtual file system) with input from <stdin>, then runs the tool on the new content using the compilation options of the source file. This mode is currently used for editor integration. 🦋
• --style=<string> — the fallback style for reformatting after inserting new headers, used when there's no clang-format config file found. 💜

lowkey important: <source0> [... <sourceN>] means you can pass more than one source file. Bring the whole friend group. 🫶

---

🌈 SEE ALSO 🌈

ngl bestie, the original page didn't send you anywhere else. It's giving self-sufficient main character energy. 💅

---

that's the whole manual, fr fr. this was clang-include-fixer 17, page dated June 2025, straight out of User Commands. go forth and fix those includes, queen. 👑✨🎀