wsh:core-mcp

Document core wsh MCP commands for driving terminal sessions.

5|2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/deepgram/wsh --skill wsh-core-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wsh:core-mcp
Source: https://github.com/deepgram/wsh/tree/main/skills/wsh/core-mcp
Command: npx skills add https://github.com/deepgram/wsh --skill wsh-core-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides background knowledge about the wsh terminal API for MCP clients to drive terminal sessions, helping developers understand how to send input, read screen data, wait for idle, and manage visual elements like overlays and panels.

Core Features & Use Cases

  • MCP tool surface: Learn the core commands such as wsh_run_command, wsh_send_input, wsh_await_idle, wsh_get_screen, wsh_overlay, wsh_panel, and session management to orchestrate terminals.
  • Session orchestration: Build automation flows that drive multiple sessions, coordinate prompts, and extract results from screen output.
  • UI integration: Use overlays and panels to present contextual guidance or status within the human terminal.

Quick Start

Start the MCP-enabled wsh server and use the core-mcp tools to drive and automate a terminal session.

Frequently Asked Questions about wsh:core-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate terminal sessions using the MCP API?

To automate terminal sessions via MCP, use commands like wsh_send_input to send keystrokes, wsh_get_screen to read output, and wsh_await_idle to wait for process completion, enabling fully automated terminal orchestration.

What MCP tools are available for terminal session management?

Available MCP tools include wsh_run_command, wsh_send_input, wsh_await_idle, wsh_get_screen, wsh_overlay, and wsh_panel, covering session management, visual overlays, and input capture for driving terminal automation.

Can I coordinate multiple terminal sessions through an MCP client?

Yes, you can coordinate multiple terminal sessions through an MCP client by using the session management and federation commands to orchestrate separate sessions, synchronize prompts, and extract results from individual screen outputs.

How do overlays and panels work in terminal automation?

Overlays and panels integrate with terminal automation by presenting contextual guidance or status indicators within the human terminal, allowing MCP clients to display visual UI elements without disrupting the underlying session flow.

How do I read terminal output from an automated session?

You read terminal output from an automated session by using the wsh_get_screen command to capture screen data after sending input and waiting for the session to reach an idle state, ensuring accurate extraction of command results.

What is the process for starting an MCP-enabled terminal server?

Start the MCP-enabled wsh server to expose the core-mcp tool surface, allowing your MCP client to connect, send input, read screen data, and manage visual elements like overlays and panels within the terminal session.