GitKraken Desktop Documentation

GitKraken AI Features Overview

Last updated: November 2026

GitKraken AI in GitKraken Desktop helps developers generate commit messages, explain commits and branches, draft pull request text, resolve merge conflicts, and customize AI providers and prompts. Use this page to understand which AI workflows are available, when to use them, and which features require a paid GitKraken subscription.

GitKraken AI requires a paid GitKraken subscription.

Requirements and limits

  • Product: GitKraken Desktop with GitKraken AI enabled
  • Plan: Paid GitKraken subscription required
  • Setup location: Preferences > GitKraken AI for provider, model, and prompt settings
  • Preview feature on this page: AI Commit Composer

Status, plan, and setup location for each feature:

Feature What it generates or does Status Plan Setup location
AI Commit Message Commit message suggestions from staged changes GA Paid subscription Commit Panel
AI Commit Composer Compose or recompose commits into a cleaner history Preview Paid subscription Commit Panel
AI Explain Natural-language explanations of commits and branches GA Paid subscription Commit Graph and context menus
AI Pull Request Description Draft pull request summaries and descriptions GA Paid subscription Pull request description field
AI provider and prompt settings Model, provider, and prompt customization GA Paid subscription Preferences > AI

GitKraken On-Premise users: The default GitKraken-hosted AI provider is not available in Serverless or Self-Hosted Server deployments. To use GitKraken AI in an on-premises environment, you must configure a Custom URL that points to a private or internal AI service. See How to use a custom API endpoint for setup steps.

Quick Start

To generate a commit message:

  1. Stage your changes in the Commit Panel.
  2. Click the AI icon (sparkle) next to the commit message field.
  3. Review the suggested message and adjust as needed before committing.

To compose commits with AI from staged changes:

  1. Stage your changes, then click Compose commits with AI in the Commit Panel.
  2. Review the commits GitKraken AI proposes. Reorder, squash, or edit their messages in the Commit Composer.
  3. Click Create Commits to apply, or Cancel to discard.

To recompose existing commits:

  1. Select a contiguous range of commits in the graph using Shift or Cmd/Ctrl.
  2. Right-click the selection and choose Recompose n commits with AI, or click Recompose commits with AI in the Commit Panel.
  3. Adjust the proposed structure and click Create Commits.

To generate a pull request description:

  • When you create a pull request, click Generate title and description to generate a summary of your changes.

To use a custom AI provider or customize the prompts, go to Preferences > AI.


How to compose and recompose commits with AI (Preview)

Use AI to help organize your Git commits into clear, logical stories. To clean up commits a coding agent made before you open a pull request, see Clean Up AI Coding Agent Commits Before Review.

When you recompose commits, GitKraken AI keeps the original commit authors and adds co-authors when a new commit combines work from more than one person. While GitKraken AI composes, the progress notification shows the current stage and the number of files and hunks.

Use AI Commit Composer when: your staged changes or recent commits need to be reorganized into a clearer narrative before you share them. Do not use it when: your commits are already atomic and you only need a quick manual message update.

What AI Commit Composer does

The AI-powered Commit Composer can:

  • Break up unstaged changes into meaningful commits.
  • Recompose selected previous commits into a new structure.
  • Reorder, squash, or edit commit messages before pushing.
GitKraken interface showing a selected range of commits before and after being composed into a cleaner history.
AI Commit Composer button in the Commit Panel

How to use AI Commit Composer

To generate commits with AI:

  • For uncommitted changes:
    1. Stage your changes.
    2. In the Commit Panel, click Compose commits with AI.
    3. Review the results in the Commit Composer, which opens when GitKraken AI finishes composing the new commits:
      • You can reorder, squash, or edit the commit messages.
      • GitKraken Desktop does not update the branch until you click Create Commits.
      • To cancel the process, click Cancel.
      • To undo any changes made during composition (such as reordering or squashing), click Reset.
Selected WIP commits in GitKraken UI with arrow pointing to the 'Compose commits with AI' button in the commit panel.
Compose commits from your WIP.
Commit Composer composing 3 commits, each set to Pick in its dropdown.
Make adjustments, then confirm to create commits.
  • For existing committed changes:
    1. In the Commit Graph, select a contiguous range of commits using Shift or Cmd/Ctrl.
    2. Do one of the following:
      • Right-click the selection and choose Recompose n commits with AI from the context menu.
      • Click Recompose commits with AI in the Commit Panel.
    3. Review the results in the Commit Composer, which opens when GitKraken AI finishes composing the new commits:
      • You can reorder, squash, or edit the commit messages.
      • GitKraken Desktop does not update the branch until you click Create Commits.
      • To cancel the process, click Cancel.
      • To undo any changes made during composition (such as reordering or squashing), click Reset.
Context menu for a selected commit showing the option to recompose a series of commits with AI.
Recompose an existing range of commits.
Commit Composer interface showing options to pick, squash, or reword each commit in a sequence.
Make adjustments, then confirm to create commits.

Commit selection rules for AI composition

  • To compose from uncommitted changes, select the WIP node and use the Commit Panel.
  • To compose from existing commits:
    • Selected commits must be contiguous and part of the current branch.
    • The range from the branch head commit to the parent of the oldest selected commit, inclusive, must contain no merge commits.

Tip: To reverse composed commits, click Undo in the toolbar. Undo reverses a compose or recompose action.


How to explain commits with AI

GitKraken AI explains in plain language what changed in the commits you select.

Use AI Explain when: you need a fast summary of what changed in one or more commits. Do not use it when: you need authoritative implementation details that should come directly from reading the diff yourself.

How to use AI Commit Explain

  1. In the Commit Graph, select one or more commits. Hold Shift or Ctrl/Cmd to select more than one. To explain 3 or more commits, select a contiguous range. For any other selection of 3 or more items, the Commit Panel shows A combined diff is not shown for this selection and offers no explain button.
Highlighted selection of multiple commits in the GitKraken commit graph.
Select one or more commits from the commit graph
  1. Click Explain commits (or Explain commit for a single commit) in the top-right corner of the Commit Panel.
The Commit Panel in GitKraken Desktop with three consecutive commits selected: the header reads 3 commits selected with an Explain commits button, followed by Viewing diff of 3 commits and the three commits.
Use the Explain button to trigger AI-generated summaries
  1. Read the summary GitKraken AI generates of what changed in the selected commits.
AI-generated summary and changelog for multiple commits, shown in the Commit Panel of GitKraken.
AI-generated explanation appears in the Commit Panel

How to generate commit messages with AI

Generate clear, consistent commit messages based on your staged changes.

Use AI commit messages when: you want a strong starting point for summarizing staged changes. Do not use them when: the exact wording carries team-specific meaning and you already know the final message you need to write.

How to generate an AI commit message

  1. Stage your changes.
Commit Panel interface showing one unstaged file with the Stage File button highlighted.
Stage your changes in the Commit Panel
  1. Click the AI button near the commit message input.
Commit Panel showing a staged file and a highlighted button for generating an AI commit message.
Click the AI button to generate a commit message
  1. Review and edit the summary and description that GitKraken AI suggests.
AI-generated commit summary and description shown in the Commit Panel.
Review and edit the suggested commit message

How to amend commit messages with AI

To amend the most recent commit message:

  1. Select the commit in the graph.
  2. Click its commit message in the Commit Panel.
Edit window open showing amended commit message and description using AI-suggested content.
Select and edit the latest commit message

Then click the AI button to generate a revised commit message.

Commit panel showing AI-assisted generation of an amended commit message and description.
Use AI to regenerate an updated commit message

How to explain branch changes with AI

Right-click any branch or HEAD commit and select Explain Branch Changes to generate a summary of all changes introduced on that branch.

Use Explain Branch Changes when: you want a high-level summary before review, handoff, or pull request writing. Do not use it when: you need to inspect exact file-level behavior instead of a summarized narrative.

Context menu in GitKraken showing the Explain Branch Changes option for generating AI-based summaries of branch differences.
Right-click a branch or HEAD commit to explain changes.

GitKraken AI selects all commits on the branch and summarizes the changes and their impact, based on the diff between the branch’s base commit and its HEAD commit.

AI-generated explanation panel in GitKraken summarizing branch changes, grouped by commit with a detailed breakdown of updates and their impact.
GitKraken AI summarizes the diff between the base and HEAD commits.

To customize how Explain Branch Changes works, go to Preferences > GitKraken AI > Explain Changes.


How to resolve merge conflicts with AI

GitKraken AI can suggest a resolution for a merge conflict. To combine the branches of two coding agents that worked in parallel, see Resolve Merge Conflicts Between AI Agent Branches.

Use AI conflict resolution when: you want a suggested starting point for resolving a conflict and plan to review the result carefully. Do not use it when: the conflict involves sensitive logic or policy decisions that require a fully manual resolution.

When you hit a merge conflict, open the conflicted file, then click Auto-resolve with AI to get a suggested resolution.

GitKraken merge conflict view showing AI-generated summary and resolution suggestions with confidence scores.
Click ‘Auto-resolve with AI’ to generate a suggested resolution

GitKraken AI analyzes the conflicting code and proposes a resolution that includes:

  • A detailed explanation of the proposed resolution
  • A confidence level for each conflicted hunk

Review the result, edit it if needed, then accept or discard the changes. Use the confidence levels to decide which hunks need closer manual review.

How to customize conflict resolution prompts

To change how GitKraken AI resolves merge conflicts, add your own instructions in Preferences > GitKraken AI > Conflict Resolution.

GitKraken AI settings panel with editable fields for customizing instructions related to stash messages, pull requests, and conflict resolution.
Set custom AI instructions for merge conflict resolution

Preview status for AI conflict resolution

AI conflict resolution is in Preview. To share your experience or suggestions, visit feedback.gitkraken.com.


How to generate stash messages with AI

GitKraken AI can generate a stash message from your staged changes, as it does for commit messages.

How to generate an AI stash message

  1. Stage your changes.
File change view in GitKraken showing 'Stage File' button next to an unstaged markdown file on the main branch.
Stage your changes for stashing
  1. Click the stash icon next to the “Commit” tab and then click the AI button.
Stash message input section with highlighted AI button labeled 'Generate a stash message with AI'.
Use the AI button to generate a stash message
  1. Review and edit the stash message that GitKraken AI generates.
Stash message input field populated with AI-generated text, 'Adds documentation for AI-generated stash messages feature.'
Review and edit the AI-generated stash message

How to generate pull request titles and descriptions with AI

When GitKraken Desktop is connected to GitHub, GitLab, Bitbucket, or Azure DevOps, you can use GitKraken AI to create a pull request with a generated title and description based on the incoming changes.

How to generate an AI pull request title and description

  1. Create a pull request from the Left Panel or by dragging a branch onto another branch.
Sidebar showing pull request filters and a highlighted 'Create Pull Request' button.
Start creating a pull request from the Left Panel or graph
  1. Click Generate title and description. If you use a pull request template, select the template first. GitKraken AI applies it.
Pull request creation panel with an AI button to generate a title and description based on branch changes.
Click the AI button to generate a pull request title and description
  1. Review and edit the title and description that GitKraken AI suggests.
Pull request form showing auto-generated title and description summarizing recent documentation changes.
Review and edit the AI-generated title and description

How to use your own AI provider key

By default, GitKraken AI uses Google Gemini Models to power commit explanations and message generation. No API key is needed and usage is included with your GitKraken subscription.

You can pick the model for each AI feature in Preferences > GitKraken AI. With the GitKraken-hosted provider, each model in the dropdown shows its AI credit multiplier after its name, such as 4.5x. Hover over the multiplier to see what it means, for example Uses 4.5x the credits of a baseline model. A model with a higher multiplier uses your weekly AI credits faster. Models you use with your own API key show no multiplier.

An open AI model dropdown listing GitKraken-hosted models with their AI credit multiplier after each name, such as 0.8x for Gemini 2.5 Flash and 4.5x for Claude Sonnet 4.5.
Each GitKraken-hosted model shows its AI credit multiplier

To use your own API key with OpenAI, Azure, Anthropic, Google Gemini, or a Custom URL, configure it in Preferences > GitKraken AI.

GitKraken Desktop Preferences > GitKraken AI with Use your own API Key to make AI requests checked and its section highlighted: Provider set to OpenAI, optional Endpoint URL, Provider API Key and Test Connection.
Configure GitKraken AI providers in Preferences

How to use a custom API endpoint

If you have advanced security requirements, use a Custom URL to send AI requests to a private or internal service.

GitKraken On-Premise users: If you are running GitKraken On-Premise Serverless or Self-Hosted Server, the default hosted provider is not reachable from your network. Custom URL is the only supported AI configuration in those environments.

A Custom URL endpoint can handle:

  • Commit explanations
  • Commit and stash message generation
  • Pull request title and description generation
  • Conflict resolution
  • Commit Composer
Custom AI provider settings in GitKraken showing provider, endpoint URL, credit limit, and API key fields.
Example of configuring a custom AI endpoint

Use a Custom URL to connect to local AI models or private endpoints, for example models hosted with Ollama, Hugging Face, OpenRouter, or an OpenAI-compatible service like LM Studio.

GitKraken does not validate, debug, or troubleshoot third-party implementations, including custom endpoints.

How to customize AI prompts

Add custom instructions in Preferences > GitKraken AI to guide how GitKraken AI responds. Each of these sections has its own instructions:

  • Global Instructions
  • Commit Message Generation
  • Explain Changes
  • Stash Message Generation
  • Pull Request
  • Conflict Resolution
  • Commit Composer
Custom instruction fields in GitKraken AI settings for commit message generation and commit explanations.
Add custom AI instructions for personalized responses

Commit Prompt Examples

Try these example instructions for commit messages:

For a short summary, use:

Keep the summary short, but informative

To add a conventional commit prefix, use:

Format the summary as:

<type>: <summary>

Where <type> is one of:
  feat, fix, docs, style, refactor, perf, test, chore

<summary> should be a short, 72-character max imperative phrase.
Only return the final commit message—no extra formatting.

How to manage GitKraken AI for an organization

To disable GitKraken AI, restrict which AI models are available, or set up organization-wide API keys and custom URLs, see the GitKraken Dev Security Controls.

To turn off GitKraken AI on your own machine, clear Enable GitKraken AI in Preferences > GitKraken AI. Your organization does not enforce this setting, so each user can turn GitKraken AI back on.

If your organization’s admin set an API key for your AI provider, the Provider API Key field in Preferences > GitKraken AI is disabled and the key stays hidden. Hover over the field to see API key configured by your organization’s admin.

What happens when you reach the weekly AI limit

When a request goes above the weekly AI usage included in your plan or trial, GitKraken Desktop shows GitKraken AI Weekly Limit Reached. What the message offers depends on your account:

  • Trial or free users: Click Upgrade GitKraken to purchase a GitKraken plan.
  • Paid organization owners and admins: Click Purchase more AI credits to add AI credits for your organization.
  • Paid organization members: Contact your organization admin or owner to request more AI credits.

How to keep or turn off GitKraken AI when you stop using it

If you have a paid plan and have not used GitKraken AI for 14 days, GitKraken Desktop shows the You’re in control of GitKraken AI dialog once. Choose one option:

  • Keep GitKraken AI On: AI features stay available. Click Keep AI On.
  • Turn GitKraken AI Off: GitKraken Desktop hides all AI buttons and menu options and sends no AI requests. Click Turn AI Off.

To close the dialog without changing anything, click Decide Later. You can change this setting at any time in Preferences > GitKraken AI.

The You're in control of GitKraken AI dialog in GitKraken Desktop, noting that GitKraken AI features have not been used in the last 14 days, with two options: Keep GitKraken AI On (Current setting), listing its benefits, and Turn GitKraken AI Off, listing what turning it off does, plus Decide Later and Keep AI On buttons.
Keep GitKraken AI on or turn it off

What’s Next?

Have more questions about GitKraken AI? See the GitKraken AI FAQ.

Have feedback about this article? Did we miss something? Let us know!
On this page