Skip to content

Floating Terminals

Open up to 5 terminals inside the Empryo desktop app to run commands, watch logs or use a REPL next to the chat, separate from the agent's own shell.

Tools2 minutes to read
Copy & share
On this page5 sections

OverviewLink to this section

The desktop app has a built-in terminal panel. Use it to run commands, watch logs or work in a REPL without leaving Empryo. You can have up to 5 terminals open at once.

Your terminals are separate from the agent. When the agent runs commands with its shell tool, those do not appear in or interfere with your terminals.

Floating terminals are a desktop feature. In the terminal UI, you are already in a terminal.

CommandsLink to this section

CommandAction
/terminalsOpen the terminal manager
/terminals newOpen a new terminal
/terminals closeClose a terminal
/terminals showShow the terminal panel
/terminals hideHide the terminal panel
/terminals renameRename a terminal

ShellsLink to this section

A new terminal starts your default shell in the current workspace folder. You can open a terminal with a different shell from the new-terminal menu (for example zsh, PowerShell, or a WSL distribution on Windows) and choose which one is the default. Each terminal is named after its shell, and you can rename it.

Working in a terminalLink to this section

The terminal panel is built on xterm.js, the terminal used by many code editors. It supports:

  • Colors, including 256-color and true color
  • Unicode and emoji
  • Clickable links
  • Mouse input for programs that use it
  • Up to 5,000 lines of scrollback
  • GPU rendering when your system supports WebGL, with an automatic fallback when it does not

Useful keys:

KeyAction
Cmd/Ctrl+FSearch the terminal output
Cmd/Ctrl+Shift+AAdd the selected text to the chat
Cmd+C (macOS) / Ctrl+Shift+C (Windows, Linux)Copy the selection
Ctrl+Shift+V (Windows, Linux)Paste

On Windows and Linux, Ctrl+C copies when text is selected. With nothing selected, it interrupts the running program as usual.

LimitsLink to this section

  • You can have at most 5 terminals open at once.
  • Each terminal is its own shell process.
  • Your terminals keep running when the agent's conversation is compacted or its context is reset.