tui-runner

Install and configure the terminal-mcp server for headless terminal emulation in Claude Code.

Updated Oct 17, 2025
One-click install
npx skills add https://github.com/x85446/claudecodetricks --skill tui-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-runner
Source: https://github.com/x85446/claudecodetricks/tree/main/skills/tui-runner
Command: npx skills add https://github.com/x85446/claudecodetricks --skill tui-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill installs and configures the terminal-mcp (MCP) server to enable headless terminal emulation within Claude Code, streamlining setup and integration.

Core Features & Use Cases

  • Automates environment detection (macOS/Linux), Node.js installation, and MCP build from the x85446 fork.
  • Performs idempotent MCP registration and path resolution to ensure reliable startup in Claude Code.
  • Supports installing, status, and reinstall flows via the /tui-runner command for maintenance and recovery.

Quick Start

Run the /tui-runner command to install, configure, and register the terminal-mcp server with Claude Code.

Frequently Asked Questions about tui-runner

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

FAQPage Schema
How do I configure a headless terminal MCP server in Claude Code?

To configure a headless terminal MCP server in Claude Code, run the /tui-runner command to automate environment detection, Node.js installation, and terminal-mcp registration.

Can I use terminal-mcp for headless terminal emulation on macOS and Linux?

Yes, terminal-mcp supports cross-platform headless terminal emulation on macOS and Linux, automatically detecting your OS to ensure correct installation and path resolution.

What do I need to install before setting up terminal-mcp in Claude Code?

You need Node.js 18+ to install terminal-mcp in Claude Code. The installation workflow checks your environment and handles the Node.js setup if required before building the server.

Why does my MCP server fail to start in Claude Code after installation?

MCP server startup failures in Claude Code often stem from incorrect path resolution. This skill ensures idempotent MCP registration using absolute paths for both node and the MCP entry point.

How do I check the status or reinstall a broken terminal-mcp server?

You can check the status or reinstall a broken terminal-mcp server by running the /tui-runner command, which provides dedicated install, status, and reinstall workflows for maintenance and recovery.

Does terminal-mcp require a specific fork to build the headless terminal emulation server?

Yes, terminal-mcp requires building from the x85446 fork to properly enable headless terminal emulation. The installation process automates this build step to ensure compatibility with Claude Code.