<!-- Markdown mirror. Canonical: https://empryo.com/docs/tools/terminals -->

# Floating Terminals

> Run up to 5 floating terminal panels in Empryo, powered by Ghostty's GPU-accelerated emulator. Watch logs and REPLs alongside chat, persisting across context

## Overview

Empryo includes floating terminal panels powered by Ghostty's terminal emulator. Run commands, watch logs, or interact with REPLs - all without leaving the chat. Up to 5 terminals can run simultaneously.

## Commands

| Command | Action |
|---------|--------|
| `/terminals` | Open the terminal manager |
| `/terminals new` | Spawn a new terminal |
| `/terminals close` | Close a terminal |
| `/terminals show` | Show the terminal panel |
| `/terminals hide` | Hide the terminal panel |
| `/terminals rename` | Rename a terminal |

## How it works

The floating terminal uses [Ghostty](https://ghostty.org/)'s Zig-based terminal emulator compiled to a native library. This gives you:

- Full ANSI/VT100 support
- GPU-accelerated rendering (via the native lib)
- Mouse support
- 256-color and true-color
- Proper Unicode and emoji rendering

The terminal state is managed independently from the chat - agent tool calls (`shell`) don't interfere with your terminal sessions.

## Limits

- **Maximum 5 terminals** can be open at once
- Terminals persist across compaction and context resets
- Each terminal runs as an independent PTY session

## Platform notes

The Ghostty native library (`.dylib` on macOS, `.so` on Linux) is included in the standalone bundle. If it's missing, Empryo starts normally - floating terminals are simply unavailable.
