gPTY — Claude Code MCP server: terminal pane control
gPTY lets an agent open terminal panes, send them input, and inspect their output. Use it to run commands through a gPTY workspace.
GPL-3.0 ★ 78 updated 2026-10-28
Open on GitHubWhat gPTY 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.
What it helps with
- 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 for the agent
- Open a pane, run
git status, and show me its output. - Run
cargo testin a terminal and wait fortest result. - Send
exitto every pane taggedbuild.
How to install gPTY
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gPTY
How do I install gPTY in Claude Code?
Standalone builds are published for Linux, macOS, and Windows. The MCP client launches gpty mcp; there is no Claude Code install command here.
What does gPTY do?
Its MCP server lets an agent control terminal panes in a gPTY workspace by opening panes, sending input, and reading output.
What do I need to build the gPTY CLI?
A Rust toolchain and a C compiler are required for the Cargo install, since the CLI bundle uses SQLite.