Beta Coming soon. This feature is still being built, so names and details may change before it ships.

Project tabs

Project tabs split a big project into parts you can switch between in one click. They work for a workspace with several folders and for a project: one folder that holds several projects, such as baby-daily with app/, backend/ and portal/, some of them git repositories of their own.

A tab is a group of projects. Everything starts in the first tab. Give a project a tab of its own, or put several projects in one tab, and the rest stay in the first tab. Agents and chats are shared by every tab.

baby-daily with two project tabs: the first tab, and "Web" holding portal and backend. App.tsx is open where you left off

When tabs appear

You openTabs show
A workspace with 2 or more folderseach folder is a project
One folder with 2 or more projects insideeach direct child folder with a nested .git, package.json, pubspec.yaml, go.mod, Cargo.toml, pyproject.toml, pom.xml, build.gradle, composer.json, Gemfile, *.csproj and the like
A .ingot-group fileone tab per project, as before

Use the + at the end of the row to add any other folder inside the project as a project.

New Project Group (project ▾ menu) saves the group as .ingot/groups/<name>.ingot-group inside the current project, with relative folder paths, so you can commit and share it. Group files saved next to the project by older builds still open.

Put projects in tabs

  • Right-click a project folder in the Project tree › Move to Tab… › an existing tab, or New Tab… and a name.
  • Or drag a project folder from the Project tree onto a tab.

The first tab is named after the workspace or folder. It holds every project no other tab holds, and with sub-projects it also keeps the folder's own files (docker-compose.yml and the like). Close a tab (×) and its projects go back to the first tab. Nothing changes on disk or in your workspace file.

A five-folder workspace: tab B holds api and docs; web, mobile and admin stay in the first tab

Switching keeps your place

Agents and chats are shared by every tab. A tab only saves its pointer: where you were, and what you had open. When you switch tabs:

PartWhat happens
Project treeshows the tab's projects: one project as its own tree, several as folders under the tab's name
Editorsthe tab's editors come back, the last one active, with the selection and the typing position where they were; unsaved files get the usual Save / Don't Save / Cancel
Treethe folders you had expanded open again
Rulesthe rule files you had open come back
Terminalsnew terminals start in the tab's first project; running terminals keep running
Agentsthe same agents and chats; the agent is told which tab you are in, its folders, your open file and its rules

Open a file that belongs to another tab (Go to File, search, or a click on a file an agent edited in the chat, a step or the review tray) and Ingot switches to that tab and shows the file there.

See where agents are working

The tab that holds a project an agent is editing shows the Ingot agent icon. It shows while the agent is working there or its edits there wait for review. With several agents the icon has a count, and its tooltip names them. An agent editing another tab never pulls you there: you stay where you are, and a click on its edited file takes you to that tab.

Backend shows the agent icon with 2, the first tab shows 1, while you stay in the first tab

The tab menu

Right-click a tab:

ItemDoes
Rename…names the tab (or double-click its name)
Icon…an icon in place of the initials
Colour…a colour for the tab's badge
Move Left / Move Rightmoves the tab one place
Position: Top / Position: Lefta row on top, or a rail on the left
Show as Foldersback to one plain tree; Show as Tabs on a folder in the tree turns tabs on again
Closeits projects go back to the first tab

Drag a tab before or after another to reorder it. A line shows where it will land.

The menu of a project tab

Tabs on the left

Position: Left turns the row into a vertical rail between the tool window stripe and the Project tree. Long names and many tabs fit better there, and the editor keeps its full height. The rail stays when the Project panel is collapsed.

Project tabs as a rail on the left

Icons and colours

  • Icon… offers None (the initials), Ingot's built-in set (mobile app, web, server, API, database, docs, tests, deploy, cloud, payments and more), and the icons of your icon pack, so an icon pack from the marketplace adds its icons here.
  • Colour… offers None, eight swatches that fit both the light and the dark theme, and Custom… for any colour.

The icon picker

A custom colour on the first tab and the web icon on blue on "Web"

Extensions can bring more icon sets: an extension binds ProjectTabIconSetContribution and registers a set with registerSet({ id, label, icons }), where each icon is a codicon name or an SVG.

Remembered

Per workspace, in Ingot's own storage and never in your files: tabs or folders, the tabs, their names, projects, order, icons and colours, the active tab and each tab's pointer. The position (top or left) is a user setting.

Settings

All of them are in Settings › Appearance › Layout and in Settings › Features.

SettingDefaultDoes
ingot.projectTabs.enabledona workspace with several folders shows project tabs
ingot.projectTabs.subProjectsona folder with several projects shows project tabs
ingot.projectTabs.agentBadgesonthe agent icon on tabs
ingot.projectTabs.positiontoptop (a row) or left (a rail)
ingot.projectTabs.looksontab icons and colours

Find Action (⌘⇧A, Ctrl+Shift+A): Move to Tab…, Rename Project Tab…, Close Project Tab, Show as Tabs, Show as Folders, Move Tab Left / Right, Project Tabs on Top / on the Left, Project Tab Icon…, Project Tab Colour…, and Next / Previous Project Tab (Ctrl+Alt+] and Ctrl+Alt+[; on macOS, ⌘ and ⌘⇧ with the backtick key).

See also Multi-folder workspaces and Worktree tabs.