# gPTY

gPTY lets an agent open terminal panes, send them input, and inspect their output. Use it to run commands through a gPTY workspace.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 78 repo stars
- Author: godot-pty
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/godot-pty/gpty
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gpty

## What it does

The gPTY MCP server gives an agent control over terminal panes. It can create a pane, send text to its shell, read the resulting output, or run a command and wait until a pattern appears. The same operations are exposed through the `gpty` CLI and a JSON-RPC socket.

gPTY is a desktop app with a tiled workspace for terminals and other panes. Standalone builds are published for Linux, macOS, and Windows, and an MCP client launches `gpty mcp`. Building the CLI with Cargo requires Rust and a C compiler because its bundled SQLite needs one. An older `gpty` earlier on `PATH` can shadow the intended binary and fail before connecting.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- open a terminal pane for a command
- send shell input and inspect the output
- run a command until a chosen output pattern appears
- send input to panes carrying a matching tag

## Example prompts
- Open a pane, run `git status`, and show me its output.
- Run `cargo test` in a terminal and wait for `test result`.
- Send `exit` to every pane tagged `build`.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
