Floating Terminals - SoulForge

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’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.