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

Session Panes

Watch up to 8 agent sessions side by side in Ingot, each in its own pane with Chat, Files, Changes and Terminal tabs.

Beta Session Panes is an optional feature and is off until you turn it on. Run several agents at once and keep an eye on all of them: what each one is saying, which files it touched, the changes waiting for review and the commands it ran.

Ingot Session Panes: two agent sessions side by side, one on its Changes tab with a file to review, one on its Terminal tab with its own worktree branchIngot Session Panes: two agent sessions side by side, one on its Changes tab with a file to review, one on its Terminal tab with its own worktree branch
Ingot Session Panes: two agent sessions side by side, one on its Changes tab with a file to review, one on its Terminal tab with its own worktree branch

Turn it on

Session Panes is easy to find in three ways, like every optional feature:

  • A suggestion in the chat. When you ask for several agents at once ("run three agents in parallel", "side by side", "compare sessions") or another agent is already running, a small card above the chat box offers Enable Session Panes. × hides it for good.
  • Settings › Features › Session Panes. An on/off switch. Turning it off hides the view and its button; your panes are kept for next time.
  • The Panes button in the status bar. One click turns Session Panes on and opens it. When it is on, the button shows how many panes are open ("2 panes") and shows or hides the view.
The Session Panes suggestion card above the Ingot chat box, with Enable Session Panes and a close buttonThe Session Panes suggestion card above the Ingot chat box, with Enable Session Panes and a close button
The Session Panes suggestion card above the Ingot chat box, with Enable Session Panes and a close button
The Panes button in the Ingot status bar, next to the model pickerThe Panes button in the Ingot status bar, next to the model picker
The Panes button in the Ingot status bar, next to the model picker
Ingot Settings, Features page: Suggest features in chat and the Session Panes switchIngot Settings, Features page: Suggest features in chat and the Session Panes switch
Ingot Settings, Features page: Suggest features in chat and the Session Panes switch

Open sessions in panes

The empty Session Panes view with New Session and Add Chat buttons and the layout switcherThe empty Session Panes view with New Session and Add Chat buttons and the layout switcher
The empty Session Panes view with New Session and Add Chat buttons and the layout switcher

The toolbar at the top of the view has:

  • New Session starts a new agent chat in a new pane, with the model you are using now.
  • Add Chat puts a chat you already have into a pane. Open Current Chat in Session Panes (Find Action) adds the chat you are looking at.
  • Start appears when .ingot/panes.json lists panes that are not open yet (see Plan panes in a file).
  • The count (2 / 8 sessions) and the layout switcher: Grid, Columns or Rows.

Each chat can be in one pane at a time. With 8 panes open, New Session and Add Chat are turned off and Ingot asks you to close a pane first. Lower Most panes at once in Settings to keep fewer.

Eight agent sessions in a four by two grid, each with Chat, Files and Changes tabs and a message boxEight agent sessions in a four by two grid, each with Chat, Files and Changes tabs and a message box
Eight agent sessions in a four by two grid, each with Chat, Files and Changes tabs and a message box

The four tabs

Each pane header shows the session's number, title, status (Thinking, Needs approval, Review, Done…), mode and model, and a chip with the worktree branch when the session runs in its own worktree. Its buttons stop a running agent, open the chat in the Agents panel, maximize the pane and close it. Closing a pane never deletes the chat.

TabWhat it shows
ChatThe session's messages, with its own message box. Messages you send here go to this session only
FilesEvery file the agent read, edited or got attached, with Edited and line counts for the ones it changed. Click one to open it
ChangesThis session's edits waiting for review, with Accept, Reject, Accept all and Reject all
TerminalThe commands the agent ran, with their output and exit code, and a box to run your own command in the session's folder (its worktree when it has one). The button next to it opens a full terminal there

When an agent asks to run a command or asks you a question, the approval card shows at the top of its pane on every tab, so you can answer without switching. While a pane is on screen, its agent's edits are reviewed in the pane instead of opening a preview tab over the panes.

One session pane maximized to fill the Session Panes view, the others hidden until it is restoredOne session pane maximized to fill the Session Panes view, the others hidden until it is restored
One session pane maximized to fill the Session Panes view, the others hidden until it is restored

Keyboard

ActionFind ActionShortcut (macOS / Windows and Linux)
Show or hide Session PanesSession Panes⌥⇧⌘[ / Ctrl+Alt+Shift+[
Turn on and openTurn On and Open Session Panes⌥⇧⌘4 / Ctrl+Alt+Shift+4
New session in a paneSession Panes: New Session in a Pane⌥⇧⌘0 / Ctrl+Alt+Shift+0
Add a chat to a paneSession Panes: Add Chat to a Pane…⌥⇧⌘- / Ctrl+Alt+Shift+-
Open the current chat in a paneOpen Current Chat in Session Panes⌥⇧⌘1 / Ctrl+Alt+Shift+1
Start panes from the fileSession Panes: Start Panes from .ingot/panes.json⌥⇧⌘2 / Ctrl+Alt+Shift+2

These work while a pane has focus:

ActionFind ActionShortcut (macOS / Windows and Linux)
Next or previous paneSession Panes: Focus Next Pane / Focus Previous Pane⌥⌘↓ ⌥⌘↑ / Ctrl+Alt+Down Ctrl+Alt+Up
Next tab in the paneSession Panes: Next Tab in Pane⌥⌘. / Ctrl+Alt+.
Maximize or restoreSession Panes: Maximize or Restore Pane⌥⌘↩ / Ctrl+Alt+Enter
Change the layoutSession Panes: Change Layout…⌥⌘; / Ctrl+Alt+;
Close the paneSession Panes: Close Focused Pane⌥⇧⌘3 / Ctrl+Alt+Shift+3

Plan panes in a file

.ingot/panes.json lists sessions to open, so you can plan a set of agents (or commit one for your team) and start them together:

{
  "version": 1,
  "layout": "grid",
  "panes": [
    { "id": "mul", "title": "Add mul", "prompt": "Add a mul helper to src/math.ts", "tab": "changes" },
    { "id": "check-node", "title": "Check node", "prompt": "Which Node version runs here?", "tab": "terminal", "worktree": true }
  ]
}
KeyWhat it means
ida short id, unique in the file: lowercase letters, digits, - and _
titlethe chat's title
promptthe first message; without one the pane opens an empty chat
modela model id; empty uses the model you are using now
modeagent (default), ask, plan or debug
tabthe tab the pane opens on: chat, files, changes or terminal
worktreetrue runs the session in its own git worktree, on a branch named after its title, like ingot/check-node-bvw3

Ingot never sends these prompts on its own: Start in the toolbar opens the panes that are not open yet and sends their prompts. Each pane in the file starts once per project. Problems in the file (a ninth pane, an unknown tab) show as .ingot/panes.json has problems in the toolbar; hover it for the details. The panes Ingot could read still start.

Settings

Settings › Tools › Session Panes:

SettingDefaultWhat it does
Most panes at once (ingot.sessionPanes.maxPanes)8How many sessions the view shows side by side, 1 to 8. Lowering it closes the panes over the limit; their chats stay in the Agents panel
Pane layout (ingot.sessionPanes.layout)gridHow panes share the space when Session Panes first opens in a project: grid, columns (side by side) or rows (stacked). The layout buttons change it for that project
Tab a new pane opens on (ingot.sessionPanes.defaultTab)chatchat, files, changes or terminal

Settings › Features:

SettingDefaultWhat it does
Session Panes (ingot.sessionPanes.enabled)falseShows the Session Panes view and its status bar button
Suggest features in chat (ingot.suggestions.enabled)trueShows the small suggestion cards above the chat box, for every optional feature
Ingot Settings, Tools › Session Panes: Most panes at once, Pane layout and Tab a new pane opens onIngot Settings, Tools › Session Panes: Most panes at once, Pane layout and Tab a new pane opens on
Ingot Settings, Tools › Session Panes: Most panes at once, Pane layout and Tab a new pane opens on

From the terminal

ingot panes edits .ingot/panes.json. It never calls a model and never starts an agent.

npx @ingotide/cli panes                                   # the panes in the file, with a layout drawing; --json
npx @ingotide/cli panes add "Write tests for the cart" --tab changes --worktree
npx @ingotide/cli panes add --title "Docs" --mode ask --model claude-sonnet-4-5
npx @ingotide/cli panes remove 2                          # by number or id
npx @ingotide/cli panes layout columns                    # grid, columns or rows
npx @ingotide/cli panes validate                          # exit 1 when the file has errors (use it in CI)
npx @ingotide/cli panes grid 7                            # how 7 panes are laid out, no file needed

clear removes every pane. Every option is on the CLI page.

FAQ

Does closing a pane stop the agent? No. The chat keeps running and stays in the Agents panel; add it back with Add Chat.

Do panes share a folder? Sessions share your project folder unless they run in their own worktree ("worktree": true), which keeps their edits and commands apart.

Can I have more than 8? No. 8 is the most that stays readable; open the rest in the Agents panel.