GIT-BIG-PICTURE(1)

💖 NAME 💖

git-big-picture — the manual page for it is GIT-BIG-PICTURE(1), and bestie, it's literally a Git repository visualizer ✨

---

🦋 SYNOPSIS 🦋

git-big-picture OPTIONS [REPOSITORY]

---

🌈 DESCRIPTION 🌈

Visualize Git repositories 💅 That's the whole vibe. You feed it a repo, it gives you a picture of the repo. Iconic behavior, honestly.

---

🎀 positional arguments:

• REPOSITORY — the path to the Git working directory (default: whatever directory you're standing in right now, i.e. the current directory) 🫶

---

💜 options:

• -h, --help — show this help message and then dip, exit 🎀
• --version — show the program's version number and exit, periodt
• --pstats FILE — run the cProfile profiler and write pstats output to FILE 📊
• -d, --debug — activate debug output, for when you need to see everything 👀

---

👑 output options 👑

Options to control output and format — the ~aesthetic~ section 🌸

• -f FMT, --format FMT — set the output format [svg, png, ps, pdf, ...] ✨
• --history-direction {downwards,leftwards,rightwards,upwards} — enforce a specific direction of history on Graphviz (default: rightwards) 🧭
• --simplify — remove edges implied by transitivity using the Graphviz filter "tred" (default: do not remove implied edges) ✂️
• -g, --graphviz — output lines suitable as input for dot/graphviz 🖇️
• -G, --no-graphviz — disable dot/graphviz output 🙅
• -p, --processed — output the dot processed, binary data 💾
• -P, --no-processed — disable binary output 🚫
• -v CMD, --viewer CMD — write the image to a tempfile and start the specified viewer 🖼️
• -V, --no-viewer — disable starting the viewer, no peeking 🙈
• -o FILE, --outfile FILE — write the image to the specified file 📁
• -O, --no-outfile — disable writing the image to a file, we're just not doing that today
• -w SECONDS, --wait SECONDS — wait for SECONDS seconds before deleting the temporary file that is opened using the viewer command (default: 2.0 seconds); this helps e.g. with viewer commands that tell other running processes to open that file on their behalf, to then shut themselves down — like, it's giving patience, and the patience is load-bearing ⏳

---

💅 filter options 💅

Options to control commit/ref selection — who gets invited to the graph, fr fr 🌟

• -a, --all — include all commits 💯
• -b, --branches — show commits pointed to by branches 🌿
• -B, --no-branches — do not show commits pointed to by branches 🌿🚫
• -t, --tags — show commits pointed to by tags 🏷️
• -T, --no-tags — do not show commits pointed to by tags 🏷️🚫
• -r, --roots — show root commits 🌱
• -R, --no-roots — do not show root commits 🌱🚫
• -m, --merges — include merge commits 🔀
• -M, --no-merges — do not include merge commits 🔀🚫
• -i, --bifurcations — include bifurcation commits; a bifurcation commit is a commit that is a parent to more than one other commits, i.e. it marks the point where one or more new branches came to life; bifurcation commits can also be thought of as the counterpart of merge commits 🌳✨
• -I, --no-bifurcations — do not include bifurcation commits 🌳🚫
• -c, --commit-messages — include commit messages on labels 💬
• -C, --no-commit-messages — do not include commit messages on labels 💬🚫

---

🌟 EPILOG 🌟

git-big-picture is software libre, licensed under the GPL v3 or later license. 🕊️

Please report bugs at https://github.com/git-big-picture/git-big-picture/issues — thank you! 💖 Seriously, thank you, the maintainers are reading and they appreciate you 🫶

---

And that's a wrap, bestie — this was git-big-picture version 1.3.0, from March 2024, hanging out in the User Commands corner of the manual. Slay, bye 👑💅