kitepon-rgb avatar

Aiterm Mcp

kitepon-rgb/aiterm-mcp

Gives Claude a single persistent tmux-backed terminal instead of spawning a new shell for every command. Six tools (pty_open, pty_send, pty_read, pty_key, pty_close, pty_list) let you launch a session, send text into it, and read back token-reduced output with four-layer completion detection (exit status, prompt matching, quiescence, timeout). The real win is nested sessions: ssh into a box or docker exec into a container once, then every subsequent command rides that same authenticated session without reconnecting. No more fail2ban lockouts or MaxStartups rejections from rapid fire connections. Sessions survive server restarts because tmux holds the PTY. Works on Linux, macOS, WSL2, and native Windows (proxies through WSL for tmux). You can even tmux attach to the same socket and watch the AI work.

GitHub stars
6
tools
4
transport
STDIO
last updated
Aug 13, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

pty_openOpens a persistent terminal session; defaults to bash on POSIX and PowerShell 7 on Windows.

Opens a persistent terminal session; defaults to bash on POSIX and PowerShell 7 on Windows.

No parameter schema in public metadata yet.

pty_listLists sessions, with optional registered non-secret environment values and a structured receipt.

Lists sessions, with optional registered non-secret environment values and a structured receipt.

No parameter schema in public metadata yet.

pty_observeReturns the state, liveness, process identities and activity of a session.

Returns the state, liveness, process identities and activity of a session.

No parameter schema in public metadata yet.

agent_launchLaunches a coding agent harness into a session and verifies its readiness before returning.

Launches a coding agent harness into a session and verifies its readiness before returning.

No parameter schema in public metadata yet.

Sponsors

Readme

From any MCP client, launch Claude Code, Codex CLI, Grok CLI, Cursor Agent CLI, or Antigravity CLI through one harness API inside a persistent interactive TUI.

Aiterm — a shared forest observatory where different intelligences work in one persistent execution space
This image represents different intelligences sharing one persistent workspace and advancing the same work from their own perspectives.

Aiterm

CI npm weekly downloads node license: MIT

(日本語: README.ja.md)


View the full README on GitHub

Details

Repository
github.com/kitepon-rgb/aiterm-mcp
Package
aiterm-mcp
Transport
STDIO
Registry
MCP registry, active