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:
- Stage your changes in the Commit Panel.
- Click the AI icon (sparkle) next to the commit message field.
- Review the suggested message and adjust as needed before committing.
To compose commits with AI from staged changes:
- Stage your changes, then click Compose commits with AI in the Commit Panel.
- Review the commits GitKraken AI proposes. Reorder, squash, or edit their messages in the Commit Composer.
- Click Create Commits to apply, or Cancel to discard.
To recompose existing commits:
- Select a contiguous range of commits in the graph using Shift or Cmd/Ctrl.
- Right-click the selection and choose Recompose n commits with AI, or click Recompose commits with AI in the Commit Panel.
- 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.

How to use AI Commit Composer
To generate commits with AI:
- For uncommitted changes:
- Stage your changes.
- In the Commit Panel, click Compose commits with AI.
- 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.


- For existing committed changes:
- In the Commit Graph, select a contiguous range of commits using Shift or Cmd/Ctrl.
- 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.
- 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.


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

- Click Explain commits (or Explain commit for a single commit) in the top-right corner of the Commit Panel.

- Read the summary GitKraken AI generates of what changed in the selected commits.

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
- Stage your changes.

- Click the AI button near the commit message input.

- Review and edit the summary and description that GitKraken AI suggests.

How to amend commit messages with AI
To amend the most recent commit message:
- Select the commit in the graph.
- Click its commit message in the Commit Panel.

Then click the AI button to generate a revised 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.

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.

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

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
- Stage your changes.

- Click the stash icon next to the “Commit” tab and then click the AI button.

- Review and edit the stash message that GitKraken AI generates.

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
- Create a pull request from the Left Panel or by dragging a branch onto another branch.

- Click Generate title and description. If you use a pull request template, select the template first. GitKraken AI applies it.

- Review and edit the title and description that GitKraken AI suggests.

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.

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

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

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

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.

What’s Next?
Have more questions about GitKraken AI? See the GitKraken AI FAQ.