Persistent Terminal

概要

This robust Model Context Protocol (MCP) server, built with TypeScript and powered by `node-pty`, provides seamless management of persistent terminal sessions. It ensures that your terminal commands continue executing even if the client disconnects, making it an indispensable tool for AI assistants like Claude, Cursor, and Cline that perform lengthy operations. The tool offers intelligent output handling with various reading modes (full, head, tail, incremental) and token estimation, smart spinner animation compression to reduce verbose output, and an intuitive web-based interface for real-time terminal interaction and monitoring. Additionally, it integrates with OpenAI Codex CLI for automated bug fixing, generating detailed reports and streamlining the development workflow.

主な機能

• Intelligent Output Management: Read terminal output with full, head, tail, incremental, and token estimation modes from a circular buffer.
• 1 GitHub stars
• Web-based Management UI: Visualize and interact with terminals in real-time via a browser-based interface with WebSocket push updates.
• Automated Bug Fixing with Codex: Integrate OpenAI Codex CLI to automatically analyze and fix code bugs, generating detailed repair reports.
• Persistent Terminal Sessions: Continue running commands after client disconnection with multi-session management and automatic cleanup.
• Spinner Animation Compression: Automatically detect and compress noisy progress animations from commands like npm install, while retaining critical logs.

ユースケース

• Empowering AI assistants (e.g., Claude, Cursor) to execute long-running development or infrastructure tasks without interruption.
• Streamlining software development by automating code bug identification and repair using AI capabilities.
• Managing multiple independent and persistent shell sessions for various projects or remote operations.