> ## Documentation Index
> Fetch the complete documentation index at: https://soulforge.proxysoul.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Floating Terminals

> Spawn, resize, and manage terminal sessions alongside the chat.

## Overview

SoulForge 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, SoulForge starts normally — floating terminals are simply unavailable.