USDAUTHORS(1)

💅 USDAUTHORS(1) 💅

okay so real quick — this is from the User Commands manual, bestie, and it's genuinely such a vibe check for anyone doing USD forensics 🕵️‍♀️✨

✨ NAME ✨

usdauthors — the manual page for usdauthors 26.11.1 🎀 literally the little tool that tells you who authored what in your USD file, and honestly? iconic.

🌸 SYNOPSIS 🌸

usdauthors [OPTIONS] inputPath

🦋 DESCRIPTION 🦋

usdauthors : lists the authorship records in a USD file, grouped by prim 💖 Each record represents a single authoring step (like generation, export, or a manual cleanup pass — you know, the whole lore of how a prim came to be).

Records get read from the composed stage. Want more? Use --debug and it'll also flag records that were hidden or collapsed by composition 👀 Or use --layer if you only want to see what a single layer authors. Both extremely valid, no cap.

📍 Positionals

• inputPath TEXT REQUIRED — the input file to process. Yeah, you gotta give it one. Required. Non-negotiable, bestie 🙈

💅 OPTIONS 💅

• -h, --help — prints this help message and dips out. classic ✨
• -d, --debug — also examines every prim spec contributing to each prim, flagging records shadowed by an explicit apiSchemas list in a stronger layer, and records applied in more than one prim spec. It's slower, but it's for debugging, so like… you knew that going in 💀
• --unloaded — do not load payloads. simple as 🫶
• -s, --summary — prints a summary of found records, including software package and digital source type tallies 🔥 the receipts, basically.
• -l, --layer — inspects a single layer without composition. This one reaches specs that are unreachable via composed stages — like the ones hiding inside unselected variants 👑 It ignores --debug and --unloaded, since those two are all about composition. iykyk.

lowkey important note: --layer is the main character when you need to see things composition won't show you, but it does not play nice with --debug or --unloaded — it just ignores them, fr fr.

and that's the whole page, bestie 🌈 usdauthors 26.11.1, dated October 2026 — go forth and trace those authorships 💜🦋⭐