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

Terminal sessions

The bottom panel has one Terminal tab, however many terminals you open and however many commands the agent runs. Inside it, the terminal is on the left and a narrow list of your sessions is on the right.

The Terminal tab with two bash sessions in the Terminal sessions list on the right and + above the list; the selected one is shown on the leftThe Terminal tab with two bash sessions in the Terminal sessions list on the right and + above the list; the selected one is shown on the left
The Terminal tab with two bash sessions in the Terminal sessions list on the right and + above the list; the selected one is shown on the left

The session list

  • + above the list opens a new terminal.
  • A row shows an icon, the shell's name and its folder. Click a row to show that session on the left.
  • × on a row closes that terminal.
  • Your terminals work as before: keys, copy and paste, and restoring them after a restart. Only their tabs are folded into the one Terminal tab, so Problems, Output and Ports stay in view.

Commands the agent runs

A long command the agent starts, such as npm run serve, is a row in the list from the moment it starts, never a tab of its own. Its row shows the command, its state (running, the exit code, stopped) and how long it ran.

  • Click the process row in the chat tray to open the Terminal tab with that row selected.
  • A command the agent starts does not take the place of a terminal you are looking at. It shows when you pick its row. With no terminal of yours on screen, it shows as before.
  • × on a command's row closes its terminal; the command keeps running. To stop it, press Ctrl+C in its terminal or Stop on its row in the chat tray.
  • The six newest finished commands stay listed. Running commands and commands whose terminal is open always stay.
npm run serve, started by the agent, as a row with running · 8 s under the bash session; the chat tray row opened itnpm run serve, started by the agent, as a row with running · 8 s under the bash session; the chat tray row opened it
npm run serve, started by the agent, as a row with running · 8 s under the bash session; the chat tray row opened it

Keys

Click in the list or move to it with Tab, then:

KeyDoes
↑ / ↓move the focus one row (it stops at the first and last row)
Home / Endgo to the first / last row
Entershow the focused row in the terminal

Moving the focus does not switch the terminal by itself; Enter does.

Clear finished

Once a command the agent ran has ended (with an exit code, failed or stopped), Clear finished (the clear-all icon) shows next to +. It closes those commands' terminals and removes them from the list, like Clear finished in the chat's process list. Running commands and your own terminals stay.

Clear finished next to + above the list, after npm run serve was stopped and node -e console.log(7) ended with exit 0Clear finished next to + above the list, after npm run serve was stopped and node -e console.log(7) ended with exit 0
Clear finished next to + above the list, after npm run serve was stopped and node -e console.log(7) ended with exit 0

Closing the Terminal tab

The Terminal tab stands for every session in the list. With more than one session listed, its × (or a middle click on the tab) asks Close the Terminal tab? with Close All and Cancel. Close All closes every session's terminal; commands the agent runs keep running and stay in the chat. With one session the tab closes at once, as before.

The question Close the Terminal tab?: 2 sessions are listed. Closing the tab closes all of their terminals. Commands the agent runs keep running and stay in the chat. With Cancel and Close AllThe question Close the Terminal tab?: 2 sessions are listed. Closing the tab closes all of their terminals. Commands the agent runs keep running and stay in the chat. With Cancel and Close All
The question Close the Terminal tab?: 2 sessions are listed. Closing the tab closes all of their terminals. Commands the agent runs keep running and stay in the chat. With Cancel and Close All

Turn it off

The session list is on by default. To give every terminal its own tab in the bottom panel again, as before, set ingot.terminal.sessionList to false in your settings file.

SettingValuesDefault
ingot.terminal.sessionListtrue: one Terminal tab with the session list; false: one tab per terminaltrue

Good to know

  • A terminal you drag to the editor area or split beside another keeps its own tab and has no list.
  • The » button of the bottom panel (Bottom panel tabs) does not count or list the terminals behind the Terminal tab.