Skip to content
Draft
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-17-7-recompose-branch-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-17-8-compose-in-wip-01-v3@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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-access-composer-1-17-4-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-access-composer-2-17-4-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-access-launchpad-01-v2@2x.gif
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-ai-branch-summary-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.
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-autolinks-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-cloud-integrations-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-code-lens-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-commit-composer-17-4-01-v4@2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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-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-commit-graph-settings-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.
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-current-line-blame-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-enable-debug-log-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-export-logs-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-filter-options-2-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-git-command-palette-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.
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-output-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-proxy-settings-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-rich-commit-search-02-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
Binary file added _images/gl-settings-01-v2@2x.png
Binary file added _images/gl-sign-in-4-01-v2@2x.png
Binary file added _images/gl-sign-in-ls-update-01-v2@2x.png
Binary file added _images/gl-sign-out-4-01-v2@2x.png
Binary file added _images/gl-sign-out-ls-update-01-v2@2x.png
154 changes: 143 additions & 11 deletions gitlens/GL-Commit-Graph.md

Large diffs are not rendered by default.

54 changes: 53 additions & 1 deletion gitlens/GL-GK-AI.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,12 @@ GitLens integrates powerful AI capabilities across different subscription tiers,

Generate clear, descriptive commit messages based on your code changes, saving time and ensuring consistency across your repository. The AI analyzes your staged changes and creates meaningful messages that accurately describe what you've modified.

In addition to single commit messages, GitLens offers AI Generate Commits, which creates multiple logical commits from your working tree changes, and AI Rebase, which restructures an existing branch onto a target commit with AI-generated commits. Both commands include undo support and first-time confirmation dialogs.

**How to access:**
- From the Command Palette: `GitLens: Generate Commit Message with AI`
- From the Command Palette: `GitLens: Generate Commits with AI` (creates multiple commits from working changes)
- From the Command Palette: `GitLens: AI Rebase` (restructures branch commits)
- From the SCM panel: Click the "Generate Commit Message" button
- During the commit process: Look for the AI option in the commit interface

Expand Down Expand Up @@ -53,8 +57,9 @@ 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`
Gitkraken AI can also be used to generate summaries in Branches, Working changes, and Stashes.
Gitkraken AI can also be used to generate summaries for Commits, Branches, Working Changes, and Stashes.

What a specific commit introduced – ✨Explain Commit
What changed across all commits in a branch – ✨Explain Branch
What you’ve modified in your working directory – ✨Explain Working Changes
What you’ve previously stashed – ✨Explain Stash
Expand All @@ -64,6 +69,7 @@ You’ll find ✨Explain options for commits, branches, stashes, and working cha
- In the Commit Graph
- Available as commands in the command palette
- In many GitLens views: Commits, Branches, Stashes, Search & Compare, etc.
- In editor blame hovers via the ✨Explain button

### AI Changelog Creation `Pro`
**Available in:** Advanced and Business plans only
Expand All @@ -87,6 +93,43 @@ Open Pull Requests: Automatically generate clear PR titles and descriptions dire

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

### AI Review `Pro`
**Available in:** Pro, Advanced, and Business plans

Review commits and working changes with AI-powered analysis that surfaces severity-tagged insights directly in the Commit Graph details panel. AI Review identifies potential issues, highlights notable patterns, and provides actionable feedback on your changes.

**How to access:**
- In the Commit Graph: Select a commit or working changes, then open the Review mode in the details panel
- Customize review behavior with the `gitlens.ai.reviewChanges.customInstructions` setting

You can configure separate AI models for different features (such as compose and review) to optimize for your preferred balance of speed and quality.

### AI Auto Rebase `Pro`
**Available in:** Pro, Advanced, and Business plans

Automate rebasing with AI-assisted conflict resolution. AI Auto Rebase handles the end-to-end rebase process, automatically resolving conflicts based on a configurable confidence threshold. A rebase summary sheet shows what was resolved and how, and full undo support lets you revert the operation if needed.

**How to access:**
- From the Command Palette: `GitLens: AI Auto Rebase`
- From the Commit Graph: Right-click a branch and select AI Auto Rebase

**Key settings:**
- `gitlens.ai.autoRebase.confidenceThreshold` — Set the minimum confidence level (0-1) for automatic conflict resolution
- `gitlens.ai.resolveConflicts.customInstructions` — Provide custom instructions for how conflicts should be resolved

### Compose and Recompose `Pro`
**Available in:** Pro, Advanced, and Business plans

Shape your commit history with AI-assisted commit crafting and branch restructuring.

- **Compose**: Craft clean, logical commits from your uncommitted working changes using the Commit Composer in the Commit Graph
- **Recompose**: Restructure existing commits on a branch using AI. Recompose commands let you reorganize, split, or combine commits for a clearer history

**How to access:**
- From the Commit Graph: Enter Compose mode to create commits from working changes
- From the Commit Graph context menu: Right-click commits to access Recompose Branch, Recompose from Commit, or Recompose Selected Commits
- From the Command Palette: `GitLens: Recompose Branch`

---
## AI Credit Allocation by Plan

Expand All @@ -106,6 +149,7 @@ GitLens offers flexibility in choosing your AI provider:
3. **Custom Provider** (BYOK): Connect your own key from supported AI services
>
- New OpenAI and Google models
- Mistral
- Self-hosted Azure AI models
- OpenAI-compatible API providers
- Local Ollama models
Expand All @@ -128,6 +172,14 @@ To configure your AI provider:
- **Credit usage monitoring**: Track your credit consumption for better allocation management
- **Default AI mode**: Choose between concise or detailed outputs for each feature

### AI File Exclusions

Control which files are included in AI context to protect sensitive data:

- **Ignore files**: GitLens respects `.aiignore`, `.cursorignore`, and `.aiexclude` files in your repository to exclude matching paths from AI prompts
- **Exclude setting**: Use the `gitlens.ai.exclude.files` setting to define additional file patterns to exclude
- Common files like lock files, minified assets, and build output directories are excluded by default

### Organization-Level Controls `Business`

- **Enforceable AI rules**: Set organization-wide policies for AI usage
Expand Down
18 changes: 14 additions & 4 deletions gitlens/GL-Integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ GitLens supports a wide range of remote providers to enhance your Git workflow i
- Gitea
- Gerrit
- Bitbucket (Cloud and Server)
- Azure DevOps
- Azure DevOps (Cloud and Server)
- Linear (issue tracking)

You can also define [custom remote providers or providers with custom domains](/gitlens/settings/#remote-provider-integration-settings).

Expand Down Expand Up @@ -42,6 +43,7 @@ You can use the following GitLens commands to interact with files, commits, and
### Files

- **Open File from Remote** (`gitlens.openFileFromRemote`) — Open a local file by specifying a remote file URL
- **Open Revision from Remote** (`gitlens.openRevisionFromRemote`) — Open a specific file revision from a remote URL, resolving the exact revision rather than the working copy
- **Open File on Remote** (`gitlens.openFileOnRemote`) — Open the current file or revision on the remote
- **Copy Remote File URL** (`gitlens.copyRemoteFileUrlToClipboard`) — Copy the URL of the current file or revision
- **Open File on Remote From...** (`gitlens.openFileOnRemoteFrom`) — Open a file/revision from a specific branch or tag
Expand Down Expand Up @@ -93,7 +95,7 @@ To connect GitHub or GitLab to GitLens, you'll use your GitKraken account via th
4. Click **Connect with GitHub** or **Connect with GitLab** and complete the sign-in process.
5. Select **Complete Setup** to return to Visual Studio Code and activate the integration.

You can connect multiple integrations if needed.
You can connect multiple integrations if needed, including multiple accounts for the same provider. For example, you can connect both a personal and a work GitHub account simultaneously. Use the integration settings to set a primary account, manage connections, and scope searches to a specific account.

<figure>
<img src="/wp-content/uploads/gl-connect-remote-integration-manager.png" class="help-center-img img-bordered">
Expand All @@ -104,6 +106,14 @@ You can connect multiple integrations if needed.
<p>Community users are limited to basic functionality only.</p>
</div>

## GitHub PR Stacks `PRO`

GitLens supports stacked pull request workflows on GitHub.com. When working with stacked PRs, GitLens shows stack information including the stack size, your PR's position within the stack, and the base ref. Merge operations are stack-aware, letting you choose to merge a single layer or the entire stack.

PR stack details appear in the Commit Graph pull request sheet when viewing a PR that belongs to a stack.

***

## GitHub Enterprise Server and GitLab Self-Managed Integration `PRO`

GitLens Pro supports advanced integration with GitHub Enterprise Server and GitLab Self-Managed.
Expand All @@ -115,7 +125,7 @@ Once authenticated, GitLens enhances autolinks for these services in hover cards
- Pull request and issue details directly in the Sidebar views

<figure>
<img src="/wp-content/uploads/gitlab-github-integration.png" class="help-center-img img-bordered">
<img src="/wp-content/uploads/gl-gitlab-github-integration-01-v2@2x.png" class="help-center-img img-bordered">
<figcaption style="text-align:center; color:#888">Enhanced hover cards with issue and PR metadata</figcaption>
</figure>

Expand Down Expand Up @@ -175,6 +185,6 @@ GitLens Pro supports integration with Jira Cloud via your GitKraken Account. Thi
You can also configure this via the [Integration Settings](https://gitkraken.dev/settings/integrations?source=help_center&product=gitlens) in a browser.

<figure>
<img src="/wp-content/uploads/gl-cloud-integrations.png" class="help-center-img img-bordered">
<img src="/wp-content/uploads/gl-cloud-integrations-01-v2@2x.png" class="help-center-img img-bordered">
<figcaption style="text-align:center; color:#888">Jira integration via GitLens Cloud Integrations panel</figcaption>
</figure>
2 changes: 1 addition & 1 deletion gitlens/GL-Launchpad.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ The GitLens Launchpad helps you manage pull requests by status, so you can quick
2. Search for **GitLens: Open Launchpad**, or select **Pull Request** from the status bar in VS Code.

<figure>
<img src="/wp-content/uploads/gl-access-launchpad.gif" class="help-center-img img-bordered" alt="Opening the Launchpad from the Command Palette in VS Code" />
<img src="/wp-content/uploads/gl-access-launchpad-01-v2@2x.gif" class="help-center-img img-bordered" alt="Opening the Launchpad from the Command Palette in VS Code" />
<figcaption style="text-align: center; color: #888">Accessing the Launchpad</figcaption>
</figure>

Expand Down
22 changes: 14 additions & 8 deletions gitlens/GL-Visual-File-History.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,26 +8,32 @@ taxonomy:

<kbd>Last updated: August 2025</kbd>

## Visual File History
## Visual History

The GitLens **Visual File History** shows how a file has evolved, including when changes were made, the size of those changes, and who made them.
The GitLens **Visual History** (formerly Visual File History) shows how your code has evolved, including when changes were made, the size of those changes, and who made them. Visual History supports multiple scopes: view the history of a single file, a folder, an entire repository, or a specific branch.

---

### Open Visual File History
### Open Visual History

You can open the Visual File History view in two ways:
You can open the Visual History view in two ways:

1. From the **GitLens Inspect** sidebar.
- Open the sidebar, then select the **Visual File History** view.
- Open the sidebar, then select the **Visual History** view.
2. From the **Command Palette**:
- macOS: <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>
- Windows/Linux: <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>
- Search for **GitLens: Show Visual File History View**.
- Search for **GitLens: Show Visual History View**.

### Scope Options

- **File or Folder**: Visualize the history of a specific file or folder
- **Repository**: See the full history of your entire repository
- **Branch**: Slice history by branch to focus on a specific line of work

<figure>
<img src="/wp-content/uploads/visual-file-history.png" class="help-center-img img-bordered" alt="Visual File History view in GitLens showing commits plotted by author and time" />
<figcaption style="text-align: center; color: #888">Visual File History view</figcaption>
<img src="/wp-content/uploads/visual-file-history.png" class="help-center-img img-bordered" alt="Visual History view in GitLens showing commits plotted by author and time" />
<figcaption style="text-align: center; color: #888">Visual History view</figcaption>
</figure>

---
Expand Down
2 changes: 2 additions & 0 deletions gitlens/GL-Workflow-Cleanup-prepare-for-review.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@ GitLens uses Git intelligence to help you ship work that is easier to review, re

- [Launchpad (PR and review awareness)](https://help.gitkraken.com/gitlens/gitlens-features/#launchpad-pro)

- [Start Review](/gitlens/gl-accelerate-pr-reviews/#start-review-pro) (quick-pick wizard to select a PR, check out branch or worktree, and optionally open AI review chat)

- Worktrees (parallel branch workflows)

- Commit Graph context menu actions
Expand Down
14 changes: 14 additions & 0 deletions gitlens/GL-accelerate-pr-reviews.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,20 @@ To start reviewing:
</figure>


## Start Review `PRO`

The **Start Review** command provides a quick-pick wizard for jumping into a pull request review. It walks you through selecting an integration, picking a PR, and choosing how to check it out (as a branch or in a new worktree). You can also optionally open an AI chat with a review prompt to assist your review.

To use Start Review:

1. Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`).
2. Run: `GitLens: Start Review`.
3. Select your integration and pull request, then choose your checkout method.

<figure class='callout callout--warning'>
<p>This feature is available with a GitLens Pro subscription or higher.</p>
</figure>

## Worktrees

Worktrees let you check out multiple branches simultaneously in separate working directories. This means you don’t need to commit or stash in-progress changes before switching to another branch—perfect for reviewing pull requests without disrupting your workflow.
Expand Down
Loading