Consoles that keep running

Normally a console ends with its window: closing the window, quitting Termo or installing an update ends the shell and everything running in it. With Keep consoles running when Termo closes on, new consoles keep running instead, and come back when you open Termo again.

This feature is experimental.

Turn it on

Open Preferences → Console and, under Sessions, tick Keep consoles running when Termo closes.

It applies to consoles opened from then on. The ones already open stay as they were.

What happens when you close Termo

The consoles don't end. A program running in one, an agent in the middle of a task, a build or a server, carries on as if the window were still open.

When something is running in them as you quit, Quit Termo lists it under Keep running in the background, as information: nothing is lost, and Quit goes ahead. It warns only about what would end: consoles opened before the option was on, which still close with Termo.

Termo runs them in a process of its own, separate from the app, which is why they outlive it. That process ends by itself a few minutes after it has no consoles left.

This is about consoles. For the agents of the agents panel (schedules, watched folders, git hooks, webhooks), see Keep agents running with Termo closed.

When you open Termo again, each console that is still running comes back in its tab, in the same split as before, showing what it showed:

  • the screen as it is now, and what was further up,
  • the agent's status in the tab, without notifying you again about what it did while Termo was closed.

Consoles that ended in the meantime open again in their folder; if an agent's conversation was open in one, it is reopened.

Closing a tab still ends its console. Only closing the window or Termo keeps it running.

The consoles don't survive restarting or shutting down the computer.

Consoles in the background

A console can keep running without any window showing it: for example, one from a window you closed while others stayed open. These appear in each tile's ˅ menu under In the background.

  • Click one to show it in a new tab.
  • Click the × next to it to close it.

If consoles aren't being kept

If the process that keeps the consoles running stops answering, Termo doesn't wait on it:

  • New consoles open anyway, in Termo itself, as if the option were off: they close with Termo.
  • The status bar shows Consoles aren't being kept. Click it to open Preferences → Console.
  • There, under Sessions, Restart replaces that process with a new one. The consoles it kept close, and the tabs that showed them end.

If it starts answering again by itself, the warning goes away and new consoles are kept again.

From another computer

Consoles, whether they keep running or not, can also be shown and used from another computer or from your phone, over Tailscale. See Remote access.

Zellij sessions

If you have Zellij installed, each tile's ˅ menu has a Zellij submenu:

  • New session opens a new Zellij session in a tab.
  • Each existing session opens in a tab, attached to it. Sessions that ended are marked ended; Zellij brings them back when you open them.

Zellij keeps its sessions running on its own, so it is another way to have consoles that outlive Termo. Inside a Zellij tab, Zellij draws its own tabs and panes, and AI Mode can't follow the agents running in it.