# Interface

> The sidebar, tabs and panes, the right dock, palettes, the status bar and what a relaunch restores.

The window has three columns and a status bar: the **Projects sidebar** on the left, **tabs and panes** in the center, and the **right dock** on the right. Everything opens as a center tab: files, diffs, pull requests, transcripts, browsers and settings.

## Projects sidebar

<Kbd>⌘</Kbd> <Kbd>B</Kbd> shows or hides the sidebar; <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>B</Kbd> moves the keyboard into it.

- **Title strip:** the Rexa version, the update badge, and a collapse button.
- **Projects header:** **New worktree** (<Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>N</Kbd>) and **Open project** (<Kbd>⌘</Kbd> <Kbd>O</Kbd>).
- **Tree:** project → worktree → agent cards. See [Projects and worktrees](/docs/workspace/projects-and-worktrees) and [Sessions](/docs/agents/sessions).
- **Bottom:** Keymap, Extensions and Settings buttons.

Drag the sidebar's edge to resize it.

## Tabs and panes

Each worktree has its own tabs. A tab holds a console, an editor, a preview, a diff, a browser or a page such as Settings.

- **Temporary tabs:** a single click on a file opens it in an italic tab that the next click replaces. Double-click, edit, or **Keep Open** to keep it.
- **Pin a tab** from its right-click menu. Pinned tabs show a pin.
- **Panes:** <Kbd>⌘</Kbd> <Kbd>\\</Kbd> adds a column. Drag the divider to resize.
- **Middle-click** closes a tab. <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>T</Kbd> reopens the last closed tab.

| Action                    | Shortcut                                                    |
| ------------------------- | ----------------------------------------------------------- |
| New tab                   | <Kbd>⌘</Kbd> <Kbd>T</Kbd>                                   |
| New tab of a chosen kind  | <Kbd>⌘</Kbd> <Kbd>N</Kbd>                                   |
| Next / previous tab       | <Kbd>⌃</Kbd> <Kbd>Tab</Kbd> / <Kbd>⌃</Kbd> <Kbd>⇧</Kbd> <Kbd>Tab</Kbd> |
| Go to tab 1–8, last tab   | <Kbd>⌘</Kbd> <Kbd>1</Kbd> … <Kbd>⌘</Kbd> <Kbd>8</Kbd>, <Kbd>⌘</Kbd> <Kbd>9</Kbd> |
| Previously used tab       | <Kbd>⌃</Kbd> <Kbd>6</Kbd>                                   |
| Move tab right / left     | <Kbd>⌘</Kbd> <Kbd>⌥</Kbd> <Kbd>⇧</Kbd> <Kbd>→</Kbd> / <Kbd>←</Kbd> |
| Close tab or split        | <Kbd>⌘</Kbd> <Kbd>W</Kbd>                                   |

<Kbd>⌘</Kbd> <Kbd>T</Kbd> opens a console unless **Settings → Launch new tab** names something else. Consoles split further inside a tab; see [Terminal](/docs/workspace/terminal).

## Right dock

<Kbd>⌘</Kbd> <Kbd>R</Kbd> shows or hides the right dock; <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>R</Kbd> moves the keyboard into it. It shows one panel at a time, and each worktree remembers its panel and width.

| Panel   | Shortcut                                | Shows                                          |
| ------- | --------------------------------------- | ---------------------------------------------- |
| Agents  | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>A</Kbd>  | Installed agents and sessions. [Sessions](/docs/agents/sessions) |
| Files   | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>E</Kbd>  | The file tree. [Files and search](/docs/workspace/files-and-search) |
| Search  | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>F</Kbd>  | Project-wide search and replace.               |
| Git     | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>G</Kbd>  | Changes, compare and history. [Git](/docs/review/git) |
| Forge   | <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>U</Kbd>  | Pull requests, issues and CI runs. [Pull requests](/docs/review/pull-requests) |

A panel shortcut pressed while you are already in that panel returns the keyboard to the center. Right-click the dock's icon strip to reorder or pin panels; Search is unpinned by default, so its icon appears only while it is open.

## Floating terminal

<Kbd>⌘</Kbd> <Kbd>J</Kbd> shows a terminal panel over any view. See [Terminal](/docs/workspace/terminal#floating-terminal).

## Palettes

| Shortcut                                 | Opens                                              | Prefix |
| ---------------------------------------- | -------------------------------------------------- | ------ |
| <Kbd>⌘</Kbd> <Kbd>P</Kbd>                | Files. `path:line:col` opens at a position.        | `/`    |
| <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>P</Kbd>   | Commands, with their shortcuts.                    | `>`    |
| <Kbd>⌘</Kbd> <Kbd>E</Kbd>                | Live agent sessions, grouped by worktree.          | `@`    |
| <Kbd>⌘</Kbd> <Kbd>⇧</Kbd> <Kbd>W</Kbd>   | Worktrees, grouped by project.                     | `~`    |
| <Kbd>⌘</Kbd> <Kbd>N</Kbd>                | New tab: a console, an agent or a browser.         |        |

Type a prefix at the start of an empty query to switch modes. <Kbd>⌫</Kbd> on an empty query or <Kbd>Esc</Kbd> steps back. Results stop at 100.

## Status bar

| Item                    | Shows                                                       |
| ----------------------- | ----------------------------------------------------------- |
| Project and branch      | The active worktree, its branch and changed-file count.     |
| Agent usage             | Plan usage for Claude and Codex, when available.            |
| Problems                | Error and warning counts. Click for the list.               |
| Language servers        | One item per running server. Click for controls.            |
| Editor mode             | The Vim mode, when Vim is on.                               |
| Comments                | Saved [comments](/docs/review/comments) waiting to be sent. |
| Resources               | Anything over its CPU or memory budget. [Resource monitor](/docs/reference/resource-monitor) |

Right-click the bar to hide items. **rexa: toggle status bar** hides the whole bar.

## Zen mode

**rexa: toggle zen mode** closes both docks and hides the status bar. Run it again to restore what was showing.

## Text size

<Kbd>⌘</Kbd> <Kbd>=</Kbd> and <Kbd>⌘</Kbd> <Kbd>-</Kbd> change the text size everywhere in half-point steps; <Kbd>⌘</Kbd> <Kbd>0</Kbd> resets it to 13.5.

## Focus marker

A small triangle in the top-right corner marks the region that has the keyboard. Turn it off with `focus_marker` in [Settings](/docs/customize/settings).

## What a relaunch restores

Rexa saves its layout as you work and restores it on the next launch:

- The window, projects, their order, names and folding, and hidden worktrees.
- Per worktree: panes, tabs and pinned tabs, console splits, the right dock panel, the floating terminal, unsaved editor changes and unsent comments.
- Agent cards and their order.

Terminals keep running in the background while Rexa is closed and reattach on launch. Zen mode is not restored.
