Kepler Documentation

Use Profiles in Kepler

Last updated: November 2026

A profile in Kepler by GitKraken is a separate Kepler setup on the same computer. Each profile has its own tasks, repositories, folders, settings, and themes, and its own GitKraken sign-in and agent logins. Profiles run side by side, so you can keep work, personal, and client work apart and still have them all open at once.

Requirements and limits

  • Profiles are in the Kepler desktop app only.
  • To add or open a profile, sign in to your GitKraken account.
  • Every install starts with 1 profile, the default profile, named Default. It always stays first in the list, and you cannot delete it.

Manage your profiles

To see and manage your profiles, open Settings → Profiles, right under Account. You can also choose Manage profiles… from the account menu. The list shows each profile with its color, and marks the one this window belongs to as This profile. Each row has a menu with Edit, Open, and Delete….


The Profiles settings page, with Add profile above two profiles: Default, marked This profile, and Client work, each with a row menu.
Settings → Profiles, with a second profile added.

Add a profile

  1. In Settings → Profiles, click Add profile. You can also run Add profile from the command palette, or choose Add profile… from the account menu before you have a second profile.
  2. Enter a Name and pick a Profile color.
  3. Under Start from, choose one of these:
    • Blank profile starts like a clean install. You sign in and set it up the first time it opens.
    • Copy of a profile keeps that profile’s settings, repositories, themes, and GitKraken sign-in. Its tasks and agent logins stay behind, and you can sign in to another GitKraken account after it opens.
  4. Click Add to add the profile, or Add and open to also open it in a new window.

The Add profile dialog: Name reads Client work, Profile color has the purple swatch picked among twelve colors, and the Start from list is open with Blank profile and Copy of Default (selected). Cancel, Add and Add and open sit at the bottom.
Adding a profile as a copy of the Default profile.

Most agents keep a separate sign-in in each profile. An agent that uses your own sign-in in every profile says so on its card in Settings → Agents, and signing in or out of it changes it everywhere.

Switch between profiles

Each profile opens in its own windows. To open another profile, or bring its windows forward, use one of these:

  • The account menu in the top bar shows this window’s profile, marked This window. Under Other profiles, click a profile to open it.
  • The tray icon’s menu lists each profile with its windows and New Window.
  • The command palette has Open profile: and the name of each profile.
  • In Settings → Profiles, choose Open from a profile’s row menu.

Once you have more than 1 profile, each window’s title names its profile.


The account menu open under the title bar's AL avatar: Default (gray D badge), marked This window, over Alex Lee, alex.lee@example.com and the GitKraken Enterprise organization; Account settings; Other profiles with Client work (purple C badge); Manage profiles…; and Sign out.
Other profiles and Manage profiles…, in the account menu.

Rename, recolor, or reorder a profile

To rename a profile or change its color, choose Edit from its row menu. To color the top of every window in that profile, turn on Tint this profile’s windows. A window connected to a remote machine shows that machine’s color instead.

To reorder your profiles, drag a row by its handle, use Move profile up and Move profile down in its menu, or press Alt/⌥ + ↑ or Alt/⌥ + ↓.

Quit with several profiles open

While another profile is running, the tray’s Quit reads Quit All, and each other profile has its own Quit profile item. Quitting the default profile quits every profile. Kepler asks once, and any profile with agent sessions still working asks before it quits. When Kepler installs an update, it closes and reopens every profile that was running.

Delete a profile

  1. Quit the profile if it is running.
  2. In Settings → Profiles, choose Delete… from its row menu.
  3. To also delete the profile’s folder in your home folder, select Also delete its folder. That folder holds the repositories the profile cloned, its worktrees, and its task folders. Work there may exist nowhere else and cannot be recovered.
  4. Click Delete profile to confirm.

Deleting a profile removes its tasks, conversations, settings, and repository list from this computer, and signs it out of GitKraken and its agents. On each remote machine the profile used, its server stops and is removed, which ends any agents still running there. Your accounts, your other profiles, and repositories added from elsewhere are not affected.



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