Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added _images/gl-commit-graph-01-v2@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added _images/gl-search-options-01-v2@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 14 additions & 8 deletions gitlens/GL-Commit-Graph.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,20 +13,24 @@ taxonomy:
The GitLens Commit Graph provides an interactive view of your repository history. It shows commits, branches, and collaborators in one place, helping you understand contributions and make faster decisions.

<figure>
<img src="/wp-content/uploads/commit-graph.png" class="help-center-img img-bordered" alt="Commit Graph in GitLens showing branches and commits" />
<img src="/wp-content/uploads/gl-commit-graph-01-v2@2x.png" class="help-center-img img-bordered" alt="Commit Graph in GitLens showing branches and commits" />
<figcaption style="text-align: center; color: #888">Commit Graph overview in GitLens</figcaption>
</figure>

---

### Open the Commit Graph

The Commit Graph leads the GitLens side bar as its main view, so it is already open when you open GitLens. Only the default location changed: a graph you moved yourself stays where you put it, and a one-time prompt offers the bottom panel instead.

To open it from the Command Palette:

1. Open the Command Palette:
- macOS: <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>
- Windows/Linux: <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>
2. Type **Show Commit Graph** and select it.

The Commit Graph opens in a new tab, where you can scroll through history and resize column widths.
In the side bar, the Commit Graph adapts to the width available. Narrow widths show compact list-style rows with the details panel below the graph. Widen the view, or move it to the bottom panel, for the columnar table layout this article describes.

<figure>
<img src="/wp-content/uploads/show-commit-graph.gif" class="help-center-img img-bordered" alt="GIF showing how to open the Commit Graph from the Command Palette" />
Expand Down Expand Up @@ -77,13 +81,13 @@ You can configure the Commit Graph to control what information is shown and how
</figure>

#### Layout Options
- **Panel Layout**: Displays the Commit Graph in the bottom panel (near the Terminal) with a details view alongside it.
- **Editor Layout**: Opens the Commit Graph in an editor tab.
- **View**: Shows the Commit Graph in the GitLens side bar, with the details panel below it. This is the default.
- **Editor**: Opens the Commit Graph in an editor tab.
- You can open the Commit Graph in both layouts simultaneously.

To switch layouts:
1. Select the settings gear in the top-right corner of the Commit Graph editor.
2. Choose **Prefer Commit Graph in Panel Layout** or **Prefer Commit Graph in Editor Area**.
1. Select the settings gear in the top-right corner of the Commit Graph.
2. Choose **Prefer Commit Graph as a View** or **Prefer Commit Graph in Editor**.

<figure>
<img src="/wp-content/uploads/gl-prefer-commit-graph-location.png" class="help-center-img img-bordered" alt="Commit Graph layout preference menu" />
Expand All @@ -106,7 +110,9 @@ Scroll markers highlight key points in the Commit Graph, including:
- Selected rows
- Search results

Use scroll markers to quickly jump to important points such as `HEAD` or refs. You can toggle this feature in the [Commit Graph settings](/gitlens/gitlens-features/#settings).
Select a marker to select and focus its row. Right-click the marker rail to turn marker types on or off without leaving the graph, or use the [Commit Graph settings](/gitlens/gitlens-features/#settings).

Additional marker types are off by default. Turn on the ones you want from the marker rail.

<figure>
<img src="/wp-content/uploads/gl-scroll-markers.png" class="help-center-img img-bordered" alt="Commit Graph scroll markers indicating branch and search results" />
Expand Down Expand Up @@ -168,7 +174,7 @@ Additional options:
- Use regular expressions

<figure>
<img src="/wp-content/uploads/search-options.png" class="help-center-img img-bordered" alt="Commit Graph search options for case sensitivity and regex" />
<img src="/wp-content/uploads/gl-search-options-01-v2@2x.png" class="help-center-img img-bordered" alt="Commit Graph search options for case sensitivity and regex" />
<figcaption style="text-align: center; color: #888">Commit Graph search options</figcaption>
</figure>

Expand Down
2 changes: 1 addition & 1 deletion gitlens/GL-GK-AI.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Understand the reasoning behind changes with AI-generated explanations of commit

<img src="/wp-content/uploads/GL-ai-commit-explain.png" class="help-center-img img-bordered">

### AI Changes Explain `Preview`
### AI Changes Explain
Gitkraken AI can also be used to generate summaries in Branches, Working changes, and Stashes.

What changed across all commits in a branch – ✨Explain Branch
Expand Down
4 changes: 2 additions & 2 deletions gitlens/gitlens-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -434,7 +434,7 @@ Learn how to configure this in our [Self-Hosting Guide](/gk-dev/gk-dev-home/#sel
The Commit Graph helps visualize your repository's commit history by displaying branches, commits, and contributors in a unified view. This makes it easier to understand project activity and make informed decisions quickly.

<figure>
<img src="/wp-content/uploads/commit-graph.png" alt="Commit Graph in GitLens showing branches and commits" class="help-center-img img-bordered">
<img src="/wp-content/uploads/gl-commit-graph-01-v2@2x.png" alt="Commit Graph in GitLens showing branches and commits" class="help-center-img img-bordered">
<figcaption style="text-align: center; color: #888">Explore your full Git history at a glance</figcaption>
</figure>

Expand Down Expand Up @@ -613,7 +613,7 @@ You can also refine results with:
- **Regular expression**

<figure>
<img src="/wp-content/uploads/search-options.png" alt="Commit Graph search filter toggles" class="help-center-img img-bordered">
<img src="/wp-content/uploads/gl-search-options-01-v2@2x.png" alt="Commit Graph search filter toggles" class="help-center-img img-bordered">
<figcaption style="text-align: center; color: #888">Adjust search filters for more precision</figcaption>
</figure>

Expand Down