# aiterm-mcp

aiterm-mcp gives an MCP client a persistent terminal for launching and driving Claude Code, Codex CLI, Grok CLI, or Cursor Agent CLI.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: kitepon
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kitepon/aiterm-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/kitepon-aiterm-mcp

## What it does

aiterm-mcp connects an MCP client to a persistent interactive terminal. With `agent_launch`, an agent picks an execution harness and receives a session it can continue step by step. The same terminal can host `ssh`, `docker exec`, a REPL, or another agent’s TUI.

The server is designed for programmatic control, so a person does not need to stay at the terminal. You can drive another CLI from an orchestration loop, a CI step, or cron. Aiterm does not create its own shared-memory layer or autonomous agent negotiation; launched tools keep using the project and harness settings they would use from a direct CLI start.

You need Node.js 18 or newer plus a multiplexer: `tmux` on POSIX systems or `psmux 3.3.8+` on native Windows. Codex CLI must also be installed and authenticated when you want Aiterm to drive Codex, otherwise that path will not work.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aiterm-mcp -- npx -y aiterm-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add kitepon-aiterm-mcp -- npx -y aiterm-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kitepon-aiterm-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "aiterm-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kitepon-aiterm-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "aiterm-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add kitepon-aiterm-mcp npx -y aiterm-mcp
```

## When to use it
- launch another coding CLI from an MCP client
- keep an interactive terminal session across turns
- run `ssh` or `docker exec` inside a controlled terminal
- hand work to another agent without a person at the terminal

## Example prompts
- Launch Codex CLI in a persistent session and ask it to inspect the migrations.
- Open a terminal through Aiterm, run `docker exec`, and report the output.
- Start Claude Code and send it the next steps through the same session.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md