# Customizing Warp

Warp is deeply customizable. Whether you use Warp primarily as a modern terminal or as an AI-powered development environment, you can tailor the experience to fit how you work. Configure the terminal side (themes, keybindings, vertical tabs, tab configs) and the AI side (model choice, agent autonomy, default mode) independently.

Use the quick-reference table to find what you need, or browse the sections below for more details.

## Quick reference

| What to customize | Where to find it                                  | Quick action                                                                                           |
| ----------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Theme             | **Settings** > **Appearance**                     | Pick a preset or [create a custom YAML theme](https://docs.warp.dev/terminal/appearance/custom-themes) |
| Prompt chips      | Right-click prompt area > **Edit prompt**         | Drag and drop context chips (directory, git branch, time, etc.)                                        |
| AI model          | Model selector in agent conversation              | Choose Claude, GPT, Gemini, or Auto                                                                    |
| Keybindings       | **Settings** > **Keybindings**                    | Import from another terminal or set custom shortcuts                                                   |
| Vertical tabs     | **Settings** > **Appearance** > **Tabs**          | Switch to a sidebar tab layout for more horizontal space                                               |
| Tab configs       | **Settings** > **Features** or `/` menu           | Save and restore tab layouts with startup commands                                                     |
| Input format      | **Settings** > **Appearance** > **Input**         | Choose Standard or Classic                                                                             |
| App icon          | **Settings** > **Appearance** > **Icon**          | Pick a custom icon (macOS)                                                                             |
| Font & text       | **Settings** > **Appearance** > **Text**          | Change font, size, and cursor style                                                                    |
| Agent autonomy    | **Settings** > **AI** > **Agents** > **Profiles** | Set what the agent can do without asking                                                               |
| Default mode      | **Settings** > **AI** > **Input**                 | Choose whether new tabs open in terminal mode or Agent Mode                                            |

***

## Appearance

In Warp, navigate to **Settings** > **Appearance** to access these options and control how Warp looks:

* [**Themes**](https://docs.warp.dev/terminal/appearance/themes) - Choose from pre-loaded themes or create your own [custom theme](https://docs.warp.dev/terminal/appearance/custom-themes) using YAML or a background image.
* [**Prompt chips**](https://docs.warp.dev/terminal/appearance/prompt) - Customize the context chips in your Warp prompt. Right-click the prompt area and select **Edit prompt** to drag and drop chips like directory, git branch, Kubernetes context, and time.
* [**App icons**](https://docs.warp.dev/terminal/appearance/app-icons) - Choose a custom app icon to distinguish Warp in your dock (macOS).
* [**Text, fonts, and cursor**](https://docs.warp.dev/terminal/appearance/text-fonts-cursor) - Change your font type, size, and cursor style.
* [**Input position**](https://docs.warp.dev/terminal/appearance/input-position) - Move your prompt and command line to the top or bottom of the window.
* [**Size, opacity, and blurring**](https://docs.warp.dev/terminal/appearance/size-opacity-blurring) - Adjust window transparency and blur effects.
* [**Pane dimming**](https://docs.warp.dev/terminal/appearance/pane-dimming) - Dim inactive panes to focus on the active one.

## Layout

Organize your workspace with tabs, panes, and window configurations.

* [**Vertical tabs**](https://docs.warp.dev/terminal/windows/vertical-tabs) - Switch to a vertical sidebar layout for tabs, giving you more horizontal space and better visibility when you have many open sessions.
* [**Tabs**](https://docs.warp.dev/terminal/windows/tabs) - Organize sessions into tabs with custom titles and colors. Right-click a tab to pick a color.
* [**Split panes**](https://docs.warp.dev/terminal/windows/split-panes) - Divide any tab into multiple panels, side-by-side or stacked.
* [**Tab configs**](https://docs.warp.dev/terminal/windows/tab-configs) - Save and restore tab layouts with predefined pane arrangements and startup commands.
* [**Global hotkey**](https://docs.warp.dev/terminal/windows/global-hotkey) - Set up a dedicated hotkey window (Quake Mode) that appears and hides with a keyboard shortcut.

## Input and editor

Configure how you type and interact with the terminal input.

* [**Standard vs Classic input**](https://docs.warp.dev/terminal/classic-input) - Standard input provides easier access to AI features and is the default for new users. Classic input resembles a traditional terminal prompt. Switch between them in **Settings** > **Appearance** > **Input**.
* [**Keyboard shortcuts**](https://docs.warp.dev/getting-started/keyboard-shortcuts) - Warp supports common shortcuts and lets you create custom ones. Import keybindings from another terminal during [migration](https://docs.warp.dev/getting-started/migrate-to-warp).
* [**Vim keybindings**](https://docs.warp.dev/terminal/editor/vim) - Enable Vim keybindings for keyboard-driven text editing in the input editor.
* **Tab key behavior** - Configure what `Tab` does in **Settings** > **Features**. Options include accepting autosuggestions or triggering completions.

## AI and models

Control how Warp's agents behave and which models they use.

* [**Model choice**](https://docs.warp.dev/agent-platform/warp-agents/model-choice) - Choose your preferred AI model (Claude, GPT, Gemini, or Auto) from the model selector in any agent conversation.
* [**Agent profiles and permissions**](https://docs.warp.dev/agent-platform/warp-agents/agent-profiles-permissions) - Configure how much autonomy the agent has: what it can auto-execute, what requires approval, and command allowlists/denylists.
* **Default mode for new sessions** - Choose whether new tabs open in terminal mode or Agent Mode by default. Set this in **Settings** > **AI** > **Input**.

## Import and sync

Bring your existing settings into Warp or keep settings synchronized across machines.

* [**Migrate from another terminal**](https://docs.warp.dev/getting-started/migrate-to-warp) - Import keybindings, color themes, and other settings when switching to Warp. Currently supports iTerm2 profiles.
* [**Settings sync**](https://docs.warp.dev/terminal/more-features/settings-sync) - Sync your Warp settings across machines (Beta).

***

## Next steps

Now that Warp looks and feels like yours, the next step is to put it to work on a real project. Open a codebase to unlock context-aware agents, or start an agent conversation to see how terminal commands and AI work together.

* [**Codebase Context**](https://docs.warp.dev/agent-platform/warp-agents/codebase-context) - Open a project and index your codebase so agents give you context-aware answers about your code.
* [**Terminal and Agent modes**](https://docs.warp.dev/agent-platform/warp-agents/interacting-with-agents/terminal-and-agent-modes) - Learn how terminal mode and agent conversations work together.