Last updated: November 2026
Connect a Git host to see the pull requests you authored, and the ones waiting on your review, in the Kepler interface. Kepler also matches each pull request to your existing worktrees, so a branch you are working on shows its pull request wherever the branch appears.
You manage providers in the Issues and pull requests section of Settings → Integrations.

Each connected Git host has a visibility line under its row. The line reads Everything visible, or shows how many items you have hidden. To leave organizations or repositories out of Todo, the lists, and the pickers, click Choose what’s visible…. See Choose what Kepler brings in.
Hosts Kepler can read pull requests from
Of Kepler’s 13 providers, 8 return pull requests:
| Provider | Also returns issues |
|---|---|
| GitHub | Yes |
| GitHub Enterprise | Yes |
| GitLab | Yes |
| GitLab Self-Hosted | Yes |
| Azure DevOps | Yes |
| Azure DevOps Server | Yes |
| Bitbucket | No |
| Bitbucket Data Center | No |
Bitbucket and Bitbucket Data Center do not appear in issue filters.
The other 5 providers (Jira, Jira Server / Data Center, Linear, Trello, and Asana) return issues only. See Issue Tracker Integrations.
Kepler supports self-hosted instances. GitHub Enterprise, GitLab Self-Hosted, Azure DevOps Server, and Bitbucket Data Center read pull requests and merge requests the same way their cloud counterparts do. Which fields come back depends on your server’s version.
You connect a self-hosted instance inside Kepler with its address and a personal access token. See Connect a self-hosted instance. Your machine needs to be able to reach the server. Kepler trusts the certificates in your operating system’s certificate store, so a server signed by your company’s own certificate authority works without extra setup.
Kepler shows GitLab merge requests as pull requests, in the same list.
Connect a Git host
To connect a cloud Git host (GitHub, GitLab, Bitbucket, or Azure DevOps), follow these steps:
- Open Settings → Integrations.
- Find the provider in Issues and pull requests and click Connect.
- Authorize Kepler on GitKraken’s website, which opens in your browser.
- Return to Kepler, where the provider shows a Connected badge.
Integrations belong to your GitKraken account, not to this copy of Kepler, so a provider you connect here is also available to the gk command-line interface (CLI) and GitKraken Desktop. To manage integrations, sign in to a GitKraken account.
If your browser did not open, copy the Connection link from the dialog Kepler shows while you authorize, and open it in a browser yourself. Each link works once, so Try again makes a new one. The dialog closes by itself once the connection appears. Reconnect uses the same dialog.
Connect a self-hosted instance
GitHub Enterprise, GitLab Self-Hosted, Azure DevOps Server, and Bitbucket Data Center connect inside Kepler with a personal access token rather than through the browser:
- Open Settings → Integrations.
- Find the provider in Issues and pull requests and click Connect. The Connect provider dialog opens.
- In Server URL, enter the server’s address, including the port and installation path when your server uses them.
- In Personal access token, paste a token with access to the repositories you need.
- Click Save connection.
The address must be http or https, without credentials, a query, or a fragment. Kepler checks the token against the server from your machine, saves it on this device, and adds the connection to your GitKraken account. The dialog reports how the check went:
| Message | What it means |
|---|---|
| Credentials verified with the server. | The server accepted the token |
| Credentials saved. Unable to verify the server certificate. Check its TLS configuration. | Kepler saved the token but could not verify the server’s certificate |
| Credentials saved without verification. Unable to reach the server. | Kepler saved the token without checking it |
| The server refused this token. Check its value and permissions. | Fix the token and save again |
Until Kepler finishes syncing the connection to your account, the provider’s row shows Cloud sync pending, and you cannot make that connection the primary. If Kepler cannot reach GitKraken, it retries when you refresh your providers.
Once connected, a self-hosted provider lists each server on its own row, with Set as primary, Replace token, and Disconnect. Each server keeps its own repositories and pull requests:
- To connect another server, click Add connection on the provider’s row.
- To renew an expired or rejected token, click Replace token on that server’s row.
- To make a server the provider’s default connection, click Set as primary.

Use these controls to manage connected providers:
| Control | What it does |
|---|---|
| Reconnect | Runs authorization again. Use it when a sign-in has expired |
| Disconnect | Removes the provider. See Disconnect a provider |
| Refresh | At the top of the section, checks every provider again |
A provider’s row can show a warning:
- Sign-in expired: the token needs refreshing. Kepler tries to refresh it by itself; Reconnect refreshes it by hand.
- Cannot connect to server: the integration is still connected, but Kepler could not reach the server. Instead of reconnecting, check that the server is up and reachable from your network or VPN.
- An organization named under the row: that organization refuses Kepler’s access, such as a GitHub organization that restricts OAuth apps. Kepler leaves out only that organization’s items.
See Issue Tracker Integrations for the warnings in full.
Cloning a repository for a pull request
When you start work on a pull request from a repository you have never cloned, Kepler first clones the repository into your Repositories folder (Settings → Repositories). How the clone signs in depends on the host:
| Host | How the clone authenticates |
|---|---|
| GitHub, GitHub Enterprise | Your connected account’s token |
| GitLab, GitLab Self-Hosted | Your connected account’s token |
| Bitbucket, Bitbucket Data Center, Azure DevOps, Azure DevOps Server | Your own Git credentials |
A self-hosted repository clones through the account connected to that server. When a provider has more than one account, the clone uses the account Kepler reads from: Read from this account where you set one, otherwise the primary.
Kepler does not write the token into the clone’s .git/config or the remote’s URL.
If Kepler has no usable token for the host, the clone uses your own Git credential helper. Kepler cannot prompt you for Git credentials, so with no credential helper the clone fails. To fix it, sign in with a Git credential helper (for example, gh auth login) or use an SSH URL, then try again.
More than one account of the same provider
You can connect several accounts of the same provider. When a provider has two or more, an Accounts list appears under its row with one entry per account.
Each entry carries two independent controls:
| Control | What it changes | How far it reaches |
|---|---|---|
| Read from this account | Which account Kepler reads this provider’s pull requests and issues from | Kepler only, and non-destructive |
| Set as primary / Primary | The provider’s primary account | Everywhere: other Kepler windows, the gk CLI, and GitKraken Desktop |
Browsing a secondary account does not change your primary. Selecting Read from this account on a second account switches what Kepler shows you and leaves the primary alone. The primary is the default read account, so a provider with no override reads through it.
Agents keep acting as the primary account. Your agents’ GitKraken MCP server always uses the primary connection of your GitKraken account, even when Kepler reads a provider through another account.
Changing either one clears that provider’s saved filters.
Disconnect a provider
Click Disconnect on the provider’s row in Settings → Integrations and confirm.

Disconnecting affects more than Kepler: it removes the connection from your GitKraken account, so the gk CLI and GitKraken Desktop lose it too. What happens to the provider depends on whether you have another account connected:
- With another account connected, Kepler promotes it to primary and the provider stays connected under it. Nothing else changes.
- With no other account connected, Kepler removes the provider entirely, with its saved filters and its rows in your lists.
You can reconnect at any time.
How pull requests attach to worktrees
Kepler matches a pull request to a worktree by its branch, so a branch shows its pull request, even after the pull request merges.
Auto-attaching a matched pull request
When you open a pull request outside Kepler (with gh in a terminal, from GitKraken Desktop, or on the web), Kepler attaches it to the task for you. The pull request then behaves like one you attached yourself: it appears in the task’s resources, and the agent receives it as context. See Tasks and Resources.
Kepler attaches only an open pull request that is yours, from a branch that matches a worktree’s branch on an active task in the same repository. To link a teammate’s pull request, attach it yourself.
Kepler never removes or replaces a link. Several active tasks can share one pull request.
What Kepler reads from a pull request
Kepler reads these fields from a pull request:
| Field | Notes |
|---|---|
| Number and title | |
| Description | The pull request body |
| State | Open, Draft, Merged, or Closed |
| Repository | Name, owner, and host |
| Author | When the provider reports one. A row shows Yours for a pull request you authored, and Review for someone else’s |
| Head and base branch | When the provider reports them |
| Fork | Whether the head branch lives on a fork, and where |
| Created at | |
| Checks and review | Shown on an open or draft pull request’s chip in a task panel: failing, pending, or passing checks, and an approved review |
| URL | Used by the open control, which names the provider: Open on GitHub, Open on Bitbucket, and so on |
A merged pull request keeps its description and author for as long as a task, archived or not, still links it.
Images embedded in a pull request’s description display in Kepler’s previews, including on GitHub Enterprise, GitLab Self-Hosted, and Azure DevOps Server.
Where your pull requests turn up
Your pull requests appear in 4 places:
| Surface | What it gives you |
|---|---|
| The Kepler interface | A Todo view lists the pull requests related to you on each connected host, or every open one in the repositories added to Kepler |
| Actions | The Action button hands the pull request to an agent. Review and Address Feedback are the 2 built-in Actions for pull requests, and Kepler picks one based on who authored the pull request |
| Review What a Coding Agent Changed | Reading the diff and the commits behind a pull request |
| Tasks and Resources | A pull request is a resource on a task, so you can attach one to work that already exists |
Todo’s scope. A Todo view’s View menu sets its Scope: Mine, the work related to you, or All, which adds the open pull requests of the repositories added to Kepler on every Git host above. See Which issues Kepler lists.
Under Mine, each provider reports a different set of pull requests related to you, so Todo lists these from each:
| Host | Pull requests Todo lists |
|---|---|
| GitHub, GitHub Enterprise | Yours, assigned to you, or ones you review |
| GitLab, GitLab Self-Hosted, Azure DevOps, Azure DevOps Server, Bitbucket Data Center | Yours or awaiting your review |
| Bitbucket | Yours, or awaiting your review in your workspaces and repositories added to Kepler |
The pull request list on a task’s Resources screen has its own scope menu: Related to me or All in my repos.
Review requests come from every host. Pull requests waiting on your review show up from every Git host above. On a large Bitbucket workspace, review requests can take a while to appear.
Lists stay current while you look at them. Pull request and issue lists refresh while they are on screen, and again when you come back to the window. When one provider fails to load, the others keep loading, and the failed provider’s last loaded pull requests stay in the list.
A failing provider is named, with its fix. When a connected provider’s read fails, Todo, the Resources screen’s lists, and a link preview show a warning that names the provider and the fix, such as Sign in to GitHub again to load its work. Each warning offers one fix:
| What went wrong | The fix offered |
|---|---|
| The sign-in needs renewing | Reconnect, or Reconnect in settings for a self-hosted provider, which needs a new token |
| The provider refused part of the request, so some organizations or repositories are missing | Open settings |
| Rate limiting, an unreachable server, an unreadable answer, or a temporary problem | Retry |
On Todo, each warning also has Filter out provider, which hides that provider from the Todo view so it stops reporting the failure. To show the provider again, clear it in the view’s Provider filter.
Rows kept from the last good load show a cloud mark on their provider chip.

The pull request picker says why its list is empty. When you add a pull request from the Resources screen, the picker explains an empty list:
- If the Linked work filter hides pull requests, the picker says how many it hides and which filter hides them, and offers Show all.
- If no connected provider can list pull requests, the picker reads Connect your code host and lists the providers that can fill the tab, each with Connect.
The Linked work filter defaults to No active task, which shows pull requests with no task or with archived tasks only. A task counts as active until you archive it, so Done and on-hold tasks count. To see every pull request, choose Any.
A row with task history carries a badge that says how many tasks it belongs to, and whether they are archived.
When nothing you have connected can list issues or pull requests, Add issue and Add PR in the New task composer open on a connect view, Connect where your work lives. Connect each provider you use, then click Continue. On the Resources screen, an empty list offers Connect your code host or Connect your issue tracker instead.
You can also start work on a pull request from GitLens or GitKraken Desktop. See Create a task.