FABRIC(1)

💖 FABRIC(1) 💖

okay so bestie, welcome to the Fabric manual page — yes that Fabric, version 2.6.0, the one from the User Commands section of the man pages. this is your girl's guide to running all the things on all the servers at once, and I'm gonna walk you through every single flag because every single one matters. no skipping. periodt. ✨

---

✨ SYNOPSIS ✨

fab [--core-opts] task1 [--task1-opts] ... taskN [--taskN-opts]

that's it, that's the whole vibe. you call fab, you hand it some core options, then you stack up your tasks task1 through taskN and each one can have its own little --task1-opts / --taskN-opts situation going on. it's giving layers. it's giving stacked. 🫶

---

🌸 DESCRIPTION 🌸

so the actual rundown lives here, and it's all about the core options — the ones that apply to the whole fab run before any of your tasks even get a say. let's get into it, one icon at a time. 💅

🔥 Core options 🔥

• --complete — prints out the tab-completion candidates for whatever parse remainder you gave it. like, "what could possibly come next?" energy. 🔮
• --hide=STRING — sets the default value of run()'s hide kwarg. default vibes, but make them your vibes. 🙈
• --no-dedupe — turns task deduplication off. no dedupe, no repeats being squashed. 🚫
• --print-completion-script=STRING — prints the tab-completion script for your preferred shell, and your options are literally bash|zsh|fish. pick your fighter. 🐚
• --prompt-for-login-password — asks for an upfront SSH-auth password prompt. get it out of the way early, bestie. 🔐
• --prompt-for-passphrase — same deal but for an upfront SSH key passphrase prompt. 🗝️
• --prompt-for-sudo-password — prompts the user at the start of the session for the sudo.password config value. front-load that drama. 👑
• --write-pyc — enables creation of .pyc files. let the bytecode be born. 🐍
• -c STRING, --collection=STRING — specify the collection name to load. 📚
• -d, --debug — enable debug output. turn the lights all the way up. 💡
• -D INT, --list-depth=INT — when listing tasks, only show the first INT levels. depth control, iconic. 🌊
• -e, --echo — echoes executed commands before running them. preview era. 👀
• -f STRING, --config=STRING — the runtime configuration file to use. your config, your rules. 📝
• -F STRING, --list-format=STRING — changes the display format used when listing tasks. should be one of: flat (default), nested, json. three aesthetics, one flag. ✨
• -h [STRING], --help[=STRING] — show core help or per-task help, then exit. the classic. 🤝
• -H STRING, --hosts=STRING — comma-separated host name(s) to execute tasks against. tag them all in. 🎯
• -i, --identity — path to the runtime SSH identity (key) file. may be given multiple times. stack those identities, queen. 🔑
• -l [STRING], --list[=STRING] — list available tasks, optionally limited to a namespace. window shopping for tasks. 🛍️
• -p, --pty — use a pty when executing shell commands. 🖥️
• -r STRING, --search-root=STRING — change the root directory used for finding task modules. relocate the hunt. 🗺️
• -R, --dry — echo commands instead of running them. the safe little rehearsal, bestie. 🙏
• -S STRING, --ssh-config=STRING — path to the runtime SSH config file. ⚙️
• -t INT, --connect-timeout=INT — specifies the default connection timeout, in seconds. ⏳
• -T INT, --command-timeout=INT — specify a global command execution timeout, in seconds. the big one. 🕰️
• -V, --version — show version and exit. 🏷️
• -w, --warn-only — warn, instead of failing, when shell commands fail. soft launch your failures. 🫠

also lowkey important: this build is running with Paramiko 3.5.1 and Invoke 2.2.0. that's the stack, no cap. 💀

---

and that's the whole page, bestie!! 🎀 this was Fabric 2.6.0, manual page dated August 2025, and you found it in the User Commands section as FABRIC(1). go forth and fab responsibly. slay. 💖✨🦋