Skip to main content

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.

​
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

CommandAction
/terminalsOpen the terminal manager
/terminals newSpawn a new terminal
/terminals closeClose a terminal
/terminals showShow the terminal panel
/terminals hideHide the terminal panel
/terminals renameRename 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.