Last updated: November 2026
Use Settings to change how Kepler, your agents, and your tasks work. Settings has 16 pages in the desktop app, listed in The Settings pages.
To open Settings, click the gear icon in the top bar, or press Ctrl/⌘ + ,. To close it, click the gear icon or press the same shortcut again.

The Settings pages
The Settings sidebar starts with a Search settings field and Setup, a progress ring that reopens the first-run checklist. Below them, it lists these pages:
| Page | What it covers |
|---|---|
| Account | Who you’re signed in as, your organization, and GitKraken AI credits |
| Profiles | The profiles on this computer, each with its own tasks, settings, and sign-ins. Desktop app only |
| Agents | Your agents, custom agents, MCP servers, agent tools, approvals, and what happens at a usage limit or when a model is overloaded |
| Tasks | How new tasks start, including the default agent, where links and notifications open a task, and how a task’s page and Dashboard panels look |
| Repositories | The repositories folder, your repos and folders, worktrees and branches, and Projects |
| Integrations | Issue tracker and Git host connections, and sessions started in your own terminal |
| Actions | Suggested Actions per item kind, and the Action list |
| General | Language, the chat’s send key, the default editor, windows, keeping agents running, and usage insights |
| Notifications | Which agent events notify you, on the desktop and in Kepler |
| Appearance | Light or dark appearance and themes, the Dashboard’s views, the chat, the terminal font, the code font, and diff layout |
| Voice | Dictation, with its models and learned words, and read aloud, all on this device |
| Keyboard shortcuts | Kepler’s keyboard shortcuts, and the keys you choose for them |
| Remote environments | The machines your agents can run on, over SSH or WSL |
| Remote Access | Opening this Kepler from another device |
| Updates | The installed version and app updates |
| Help | The docs, release notes, onboarding guides, and Kepler’s logs |
The account menu also opens Account.
Find a setting
To find a setting by name, start typing when Settings opens: Search settings already has focus. Search also matches help text and common synonyms, so a word like theme or notifications finds the right section.
When a search result or an Ask Kepler link takes you to a setting, Kepler highlights its control. If the setting is not shown, for example because it depends on something you have not set up yet, Kepler says why.
Ask Kepler can also search Kepler’s settings, and change one when you ask. It names the setting as a link you can click. Some changes need your approval first. Settings that hold secrets, such as your account or integrations, can only be linked. See Finding and changing settings.
To jump to a section, use the section links the Settings sidebar shows under the page you have open. Under Agents, the sidebar also lists each supported agent below Your agents.
Sub-pages and unsaved changes
When you open an item to edit it, such as a repository, a project, a custom agent, an MCP server, or an Action, it opens as a sub-page inside its Settings page, with a breadcrumb back to the page.
A sub-page form saves when you click Save in its footer. If a save fails, the footer shows why and keeps your edits on the form.
If you leave a sub-page with unsaved changes, however you leave, Kepler asks whether to save them before it discards anything.
Most fields outside those forms save themselves and show their status beside them. If a save fails, Kepler shows the reason, and names the setting if you have already left the page.
Go back, or your mouse’s back button, steps back through each page, sub-page, and search result you opened in Settings. To leave Settings in one click from any page or sub-page, use the back arrow in the Settings header, the gear icon, or Ctrl/⌘ + ,. When the Dashboard’s views sit Along the left side, the back arrow sits at the top of the views column instead. Each one returns you to what you were doing before you opened Settings.
Settings in a remote window
In a window connected to a remote environment, Settings shows that machine’s settings, and its header names the machine. Under its title, each page says where its settings are saved:
- Saved on {machine}: on the remote machine.
- Saved on this machine: on your own computer, for every Kepler window on it.
A section that saves somewhere other than its page has its own badge. To change this machine’s own settings from a remote window, click Open this machine’s settings in the header. The same page opens in a local window.
Some settings are kept on your own computer, such as the language, the default editor, the themes, the terminal and code fonts, and the diff layout. If Ask Kepler in a remote window changes one of these, the change applies on your computer, and a notification names it, with Undo. See Finding and changing settings.