There was an error while loading. Please reload this page .
Standalone binaries (no Godot install required) are published on GitHub Releases for Linux, macOS, and Windows.
Each release publishes a SHA256SUMS listing every asset. Check the file you downloaded before running it:
Checksums catch a corrupted or tampered download in transit. Each asset also carries a build-provenance attestation binding it to the workflow run that built it:
The binaries are not code-signed (see SECURITY.md ).
The gpty binary controls a running GUI over JSON-RPC IPC, and every release bundle ships it next to the GUI, which it starts on demand ( --no-daemon opts out). Building from source ( cargo build -p gpty , or cargo build --workspace ) is only needed when working on the CLI itself.
Once the GUI is running (launched from Godot or a release binary), the CLI connects over a Unix socket ( $XDG_RUNTIME_DIR/gpty.sock on Linux, or GPTY_SOCKET env var):
See gpty --help for all subcommands and flags.
gpty ships an MCP (Model Context Protocol) server so AI agents and coding harnesses can control the workspace. The repo-root mcp.json declares it for auto-discovery:
Tool schemas are generated from the same clap definitions as the CLI ( crates/gpty-cli/src/commands/schema.rs ), so they cannot drift from gpty --help .
See ROADMAP.md for the full feature inventory.
See SECURITY.md for the threat model, reporting process, and what gpty does not defend against. Implementation rules - the Concept Engine's ReDoS stance, PTY environment sanitization, IPC hardening, OSC 52 restrictions - live in AGENTS.md .
See CONTRIBUTING.md for setup instructions, build commands, testing, code style, and the pull request process.
See CHANGELOG.md for the complete versioned changes and history.
gPTY is free software, licensed under the GNU General Public License, version 3 or later — see LICENSE for the full text.
LICENSE-EXCEPTIONS.md adds two permissions under section 7 of that license, so the ecosystem side stays permissive:
Copyright (C) 2026 Neil Pathare.
gPTY is distributed in the hope that it will be useful, but absolutely without any warranty and assumes no liability for any usage by end-users; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Godot-based Rust multi-PTY emulator desktop application