gPTY is an innovative terminal emulator that combines the Godot game engine and Rust programming language to provide a flexible multi-pane PTY (pseudo-terminal) environment. It supports spawning and managing independent shell sessions within a resizable tiling grid, enabling users to organize terminals, code viewers, and file trees efficiently. The emulator fully supports DEC STD 070 terminal standards, including 16/256/true color modes, scrollback with regex search, and wrapped text selection.
One of gPTY's key features is its public API, which uses JSON-RPC over IPC sockets and a command-line interface. This allows AI agents, scripts, and automation tools to control the workspace by creating panes, injecting text, and observing terminal output without relying on screen scraping. The application also includes an MCP (Model Context Protocol) server to facilitate advanced AI orchestration.
The concept engine in gPTY uses regular expression triggers to capture terminal output and route it to adjacent panes, such as code viewers or inspectors, for passive observation. This design ensures that concepts only display information without injecting input into shell sessions. Additionally, gPTY offers agent observability through dedicated panes that track agent lifecycle events and enable private Q&A sessions without orchestrating agent states.
Persistence is built in, with scrollback histories, settings, workspaces, and profiles automatically saved to SQLite or JSON files and restored on restart. Users can perform full-text searches across each pane's history. gPTY is cross-platform, providing standalone binaries for Linux, macOS, and Windows that do not require a Godot or Rust toolchain to run.
The project emphasizes extensibility and automation, with a documented, versioned protocol for AI and scripting integration. The majority of the codebase, including the Godot UI layout and Rust bridge, was generated using large language models, which may introduce some unidiomatic patterns or bugs.
gPTY is open-source software licensed under the GNU General Public License version 3 or later, with exceptions allowing plugins, extensions, and configuration files to be licensed more permissively. This approach encourages ecosystem growth while maintaining core software freedoms.
This tool is relevant for developers and AI researchers seeking a programmable terminal environment that supports advanced automation and AI interaction without compromising on usability or cross-platform compatibility.