---
url: https://cuonghuunguyen.github.io/reference/settings.md
---
# Settings

Open **Settings** with Ctrl+, (⌘ , on Mac) or the **Settings** button at the bottom of the sidebar. Pick a group on the left.

![The Settings dialog](/screenshots/settings.png)

The groups sit under four headings:

| Heading | Groups |
| --- | --- |
| App | Appearance, General, Layout, Notifications, Keyboard |
| Sessions | Orchestration, Focus, Chat, Usage limits |
| Integrations | Git, Jira |
| System | Sides, Performance, Help & about |

Most settings are **kept in this browser** only. Orchestration, Focus, Chat, Usage limits (except the ring), Git, Jira, Sides, Performance and desktop notifications are saved in the daemon and apply to every browser.

## Appearance

| Setting | Options |
| --- | --- |
| Theme | Default, Catppuccin, Tokyo Night, Solarized, Nord, Dracula, One. Recolors the app, the editor, diffs, the terminal and the git graph at once. Dracula has no light colors: in light mode it shows Default. Kept in this browser. |

| App name and icon | Your own name and icon (an emoji or an image) for the browser tab and the installed app. **Change…** opens the editor; an empty name means "Claude UI". Saved in the daemon: it applies to every browser of this Claude UI. The tab changes at once. An installed app takes it when the browser next checks for updates (up to a day) or after you reinstall it. |

The theme button at the top right still cycles System, Light and Dark inside the theme.

## General

### Timeline

| Setting | Does |
| --- | --- |
| Signal only | Folds each run of tool calls into one line, like "4 tool calls · Read 3 · Grep 1". Your prompts, Claude's text, errors and waiting requests stay. Also Ctrl+Alt+S. |

### Sending

| Setting | Does |
| --- | --- |
| While Claude works, Enter | **Steers the turn** (default; Alt+Enter queues) or **queues the message** (Alt+Enter steers). A queued message waits and starts its own turn when Claude is idle. The send button follows the choice. |

### Screen

| Setting | Does |
| --- | --- |
| Keep screen awake | Holds the screen on while claude-ui is open. See [Keep screen awake](../features/keep-awake). |
| Only while a session is running | Holds it only while a session runs or waits for you. |

## Layout

### Sidebar

| Setting | Does |
| --- | --- |
| Show only active sessions | Lists only sessions that run or need input. Search still finds all. |
| Group by | **Worktree** groups a project's sessions by worktree. **Project** lists them right under the project, with their state as text. |

### Tabs

| Setting | Does |
| --- | --- |
| Tab grouping | By project, By worktree, or None |
| Compact tabs | Shows each group as one chip. Open its tabs from the chip. Needs a tab grouping. |
| Auto-close idle tabs after | Off, 1 hour or 1 day. Never closes pinned, running or unread tabs, or tabs with a draft. Sessions keep running. |

### Changes

| Setting | Options |
| --- | --- |
| Default diff view | Session changes, Uncommitted, Against branch |

### Terminal

| Setting | Does |
| --- | --- |
| Terminal position | **Bottom** (default), **Side panel** or **Main area** (a tab next to the session). See [Panes & layout](../features/panes). |

## Notifications

| Setting | Does |
| --- | --- |
| In-app notifications | A card in this page when another session needs input or finishes. On by default. |
| Push notifications | Notifications from this browser, also with the page closed. Needs HTTPS or localhost. |
| Desktop notifications on *computer* | The daemon's computer shows a system notification when no browser has push on. For every browser. |

See [Notifications](../features/notifications).

## Keyboard

Opens the [Keyboard shortcuts](shortcuts) dialog, where you can rebind every shortcut. **Show shortcut tips**: after the 2nd, 5th and 10th click on a button, a tip shows its shortcut or offers to assign one. Not on touch screens.

## Orchestration

Lets a session start and steer worker sessions. Off by default. **Notifications from workers** turns notifications for worker sessions on or off. Every setting is described on the [Orchestration](../features/orchestration#settings) page.

## Focus

| Setting | Does |
| --- | --- |
| Next for you | After a turn, Claude predicts your next prompt; finished rows on Focus show it as a chip. Off by default. Uses a small extra request per turn that reuses the prompt cache. Applies to sessions started or resumed after the change. |

## Chat

| Setting | Does |
| --- | --- |
| Inline visualizations | Claude can draw charts, diagrams and small interactive widgets in its replies ([details](../features/visualize)). On by default. Applies to sessions started or resumed after the change; off: they show as code. |

## Usage limits

| Setting | Does |
| --- | --- |
| Continue automatically after a usage limit resets | Sends "continue" to a session that the plan limit stopped, once the limit resets. |
| Usage ring shows | Highest usage, Session (5 h) or Weekly. Kept in this browser. |

## Git

The same settings as VS Code's Git extension, with the same names and values. They apply to every project and decide which repositories the repository selector and the file tree marks find.

| Setting | Does |
| --- | --- |
| Auto repository detection | `true` (default), `subFolders`, `openEditors` or `false`. |
| Repository scan max depth | How deep to scan for repositories. Default `1`; `-1` = no limit. |
| Repository scan ignored folders | Folder names skipped while scanning. Default `node_modules`. |
| Scan repositories | Extra paths to search, relative to the project folder. |
| Ignored repositories | Repositories to leave out. |
| Detect submodules / Detect submodules limit | Find submodules, at most this many (default `10`). |
| Ignore submodules | Ignore submodule changes in the file tree. |
| Open repository in parent folders | `always` (default), `never` or `prompt` (behaves as `always` here). |

## Jira

One Jira connection for the **Ticket** tab of [Create worktree](../features/projects#create-a-worktree).

| Setting | Does |
| --- | --- |
| Jira URL | Cloud: `https://<site>.atlassian.net`. Data Center or Server: the https address of your Jira (http only for `localhost` and `127.0.0.1`). Changing the host clears the saved token. |
| Email | Your Atlassian account email. Only for Jira Cloud. |
| API token / Personal access token | Cloud: an API token from id.atlassian.com › Security › API tokens. Data Center or Server: a personal access token from your Jira profile. Saved on the daemon's computer only (`secrets.json`), never shown again: the row then says **Token set**, with **Replace** and **Clear**. |
| Branch template | How a ticket names its branch. Default `{type}/{key}-{summary}`: `{type}` is `bugfix` for a Bug, `feature` for a Story, Task or New Feature, else empty; `{key}` is the ticket key; `{summary}` is the summary, shortened. |
| Ticket filter (JQL) | The tickets the Ticket tab lists, e.g. `project = ABC AND statusCategory != Done`. Typed text searches inside it; a key or ticket URL ignores it. Empty: your open tickets. |
| Test connection | Shows "Connected as *your name*" or the error. |

## Sides

Shown when a WSL distro, container or SSH host is listed. This computer is always listed, with a pencil button for its [name and icon](../features/projects#custom-names-and-icons). Per side:

| Setting | Does |
| --- | --- |
| Start with Claude UI | Starts the side with Claude UI, from the next start. Off also removes the side's projects from the sidebar. |
| Update automatically | Installs a new Claude UI build from the bundle. Needs Start with Claude UI. |
| Keep running without Claude UI (minutes) | The Grace period: how long a Hub that Claude UI started on that machine keeps running with no Claude UI attached, no browser connected and no turn running (default 30). A Hub you started there never ends by it. |
| Update | Shown when the Claude UI on an SSH host is older than yours: runs `claude-ui update` there. |

See [WSL, Docker & SSH](../features/wsl-docker).

## Performance

| Setting | Does |
| --- | --- |
| Performance monitor | Measures responsiveness on the daemon's computer. Durations and counts only; nothing leaves the computer. Below it: the results, **Clear** and **Export JSON**. |

## Help & about

### Guide

**Guided tour:** restart the short tour of projects, tabs, files, changes, git graph and terminal.

### About

The version of the web app and of the daemon. Include both in a bug report.

## Not in Settings

* **Mode:** the theme button at the top right cycles System → Light → Dark, inside the colour theme you picked in Settings › Appearance.
* **Model, mode, effort:** per session, in the [prompt box](../features/prompt-box).
* **Server options** (port, roots, remote access): [CLI flags](cli).