---
name: "git-big-picture"
section: "1"
platform: "linux"
package: "git-big-picture"
version: "1.3.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/git-big-picture"
---

# git-big-picture(1)

Visualize Git repositories

## NAME

git-big-picture - Visualize Git repositories

## SYNOPSIS

**git-big-picture** OPTIONS \[REPOSITORY\]

## DESCRIPTION

Visualize Git repositories

### positional arguments:

- REPOSITORY

  path to the Git working directory (default: current directory)

### options:

- **-h**, **--help**

  show this help message and exit

- **--version**

  show program's version number and exit

- **--pstats** FILE

  run cProfile profiler writing pstats output to FILE

- **-d**, **--debug**

  activate debug output

### output options:

Options to control output and format

- **-f** FMT, **--format** FMT

  set 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 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 image to tempfile and start specified viewer

- **-V**, **--no-viewer**

  disable starting viewer

- **-o** FILE, **--outfile** FILE

  write image to specified file

- **-O**, **--no-outfile**

  disable writing image to file

- **-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

### filter options:

Options to control commit/ref selection

- **-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!