Skip to main content
MCP server CX Codex

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 GitHub

What 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 test in a terminal and wait for test result.
  • Send exit to every pane tagged build.

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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open