> ## Documentation Index
> Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Configure Xirp appearance, sessions, terminal behavior, notifications, coding agents, projects, and diagnostics.

Open Settings with the gear icon. In the desktop app, you can also press `Cmd+,`.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-application.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=fc085b2e11315fa2e0ecdbe09fccd88c" alt="Application settings" width="1800" height="1153" data-path="xirp/assets/settings-application.webp" />

Use the search field to find a setting by name or description.

## General

**Application** contains app behavior and a button to replay the welcome tour. **Appearance** controls the theme, terminal font, font sizes, and layout density.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-appearance.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=af4ec8eb5915552aca2537b99f6417f5" alt="Appearance settings" width="1800" height="1153" data-path="xirp/assets/settings-appearance.webp" />

**Accessibility** contains visual and interaction preferences. Changes are stored locally for the Xirp installation.

## Sessions

Choose the default coding agent used for new sessions. Xirp does not translate one agent's permission or sandbox settings into another agent's controls.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-sessions.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=ad22974c26b69a885d5c5f685a21b4bb" alt="Session defaults" width="1800" height="1153" data-path="xirp/assets/settings-sessions.webp" />

Prompting settings control Xirp-owned instructions added to new sessions. Repository rules and Portal context are separate sources of instructions.

## Terminal and editor

Configure Option-key behavior, natural mouse selection, terminal scrolling, the external terminal app, editor command, and keyboard shortcuts.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-terminal.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=399b9ce126ebbf6e2dd0fe53dc883d15" alt="Terminal settings" width="1800" height="1153" data-path="xirp/assets/settings-terminal.webp" />

Use **Input & Shortcuts** to change a binding. Select a shortcut row, record the new key combination, and save it. Press `Cmd+/` for a complete reference.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/keyboard-shortcuts.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=2b4a73089df756575a18ff02a611cca7" alt="Keyboard shortcut reference" width="1800" height="1153" data-path="xirp/assets/keyboard-shortcuts.webp" />

## Git and worktrees

Choose where Xirp creates worktrees and how it names them. Project-specific setup and cleanup scripts can prepare dependencies in a new worktree or clean resources before removal.

Prefer a predictable location that is included in your backup and cleanup practices. Do not place worktrees inside another worktree unless your repository tooling expects that structure.

## Notifications

Session hooks let Xirp detect agent state and power status badges, sounds, and visual alerts.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-notifications.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=2cb03169d7037b09d07b576bacfe4f95" alt="Session notification settings" width="1800" height="1153" data-path="xirp/assets/settings-notifications.webp" />

You can disable sound while keeping visual status indicators enabled.

## Coding agents

The **Coding Agents** section shows installed agent CLIs and exposes only tested, agent-specific launch controls.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/settings-coding-agents.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=339c46bf175bdb2cf90ae13a6e71c7c5" alt="Installed coding agents" width="1800" height="1153" data-path="xirp/assets/settings-coding-agents.webp" />

Models, credentials, reasoning behavior, and most native settings remain in each coding agent's own configuration. Xirp can edit supported native configuration files, but it never exposes credential files.

## Projects

Project settings cover display behavior, Git and worktree defaults, and setup scripts. The project selector at the top of the section determines which project you are editing.

## Advanced and debug

Advanced settings include feature flags and third-party license attributions. Debug pages show connection and daemon information useful when working with support.

<Warning>
  Debug exports can contain local paths, repository names, and diagnostic data.
  Review an export before sharing it outside your organization.
</Warning>
