Project tabs
Project Tabs represent each open folder, Git repository, and Git worktree. They live in the scrollable Project Tab Bar inside the outer App Tab Bar.
App Tab Bar and Project Tab Bar layout
The App Tab Bar contains the Open Folder control, the Project Tab Bar, and the Settings and Documentation controls. Click Open Folder to open folders and repositories. Click Settings to open Zide settings. Only the scrollable middle region containing Project Tabs is the Project Tab Bar.
By default, the App Tab Bar runs horizontally below the menu bar. To switch it to a vertical sidebar layout, click View > App Tabs: Vertical. To resize the vertical App Tab Bar, drag the divider. Double-click the divider to reset it to the default width.
When the Project Tab Bar is full, arrow buttons appear at its ends for scrolling. A dropdown menu also appears for selecting a Project Tab.
Project Header layout
Each repository and worktree Project Tab has a Project Header. Its controls run from project identity on the left to project-wide actions on the right.
| Control | Description |
|---|---|
| Project name | Identifies the active folder, repository, or worktree. |
| Branch | On ordinary repository Project Tabs, browse and manage branches and worktrees, then choose an operation such as Compare, Merge, Switch/Checkout, or Create Worktree. |
| Worktree | Replaces Branch on worktree Project Tabs and manages the current worktree’s source relationship and lifecycle. |
| Remote | Selects the remote used by synchronization controls. |
| Push | Pushes local commits to the selected remote. |
| Pull | Pulls with the selected Merge or Rebase strategy; the button label shows the strategy. |
| PR/MR | Shows or creates the provider’s pull request or merge request for the current branch. |
| Refresh | Fetches from the remote and reloads the Project Tab’s initialized surfaces. |
| Repository actions | Opens less-frequent repository and Git actions. |
For a folder that is not yet a Git repository, the Project Header replaces Git controls with Init Git while retaining applicable project-wide actions.
Files, Commits, Staging, Stashes, Script Runner, and provider lists live in the Activity Bar and its panel; they are not Project Header controls.
Work with project tabs
Click a Project Tab to switch between folders, repositories, and worktrees. Its content tabs, split-pane layouts, scroll positions, and selections remain intact when you switch between Project Tabs.
Drag a Project Tab to rearrange tabs on the Project Tab Bar. Right-click a Project Tab to open options for it.