
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 toolsPublic 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.
This image represents different intelligences sharing one persistent workspace and advancing the same work from their own perspectives.
Aiterm
(日本語: README.ja.md)
Details
- Repository
- github.com/kitepon-rgb/aiterm-mcp
- Package
aiterm-mcp- Transport
- STDIO
- Registry
- MCP registry, active