Tmux를 위한 대리인 동쪽으로 향하게 한 MCP 서버 — 기본 공정 탐지, 똑똑한 방아쇠 및 1 손잡이: 구멍.

빠른 시작

Prerequisites: tmux 설치, 이동 1.26.1+ 또는 사전 내장 바이너리.

MCP 클라이언트 설정에 추가 (~/.claude/settings.json] Claude 코드에 대한):

터미널을 얻고 그것을 실행하십시오 - 설정 통화 없음, 운반 할 핸들 없음 :

왜 이 존재

AI 코딩 에이전트 (Claude Code, Codex CLI, Gemini CLI, opencode) 필요 터미널 제어. Existing MCP 서버는 dumb 파이프로 tmux를 치료합니다. 명령을 보내, 출력의 오염, 반복.

그 모델은 4 가지 방법으로 깰:

• 에이전트가 시작 npm run dev 서버가 **읽을 때 알아야 할 ** — 그렇지 않을 때 그것은 어떤 산출든지 일으킵니다.
• 에이전트는 데이터베이스 마이그레이션을 실행하고 psql이 ** 와이팅을 할 때 감지해야합니다 password** — 스크린 텍스트에서 추측하지 않습니다.
• 대리인은 5개의 가동을 사슬로 하고 각 단계 사이 보기 라운드 지구를 감당할 수 없습니다.
• 에이전트는 다른 일을하는 동안 배경 팬티에 빌드를 볼.

이 프로젝트는 4 가지 문제를 직접 해결합니다.

비교

인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 |—|—|—|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| | 언어 | TypeScript | 녹 | 노드.

tmux-mcp

Agent-oriented MCP server for tmux — native process detection, smart triggers, and one handle: the slot.

Quick start

Prerequisites: tmux installed, Go 1.26.1+ or a pre-built binary.

# Install via Go
go install github.com/MadAppGang/tmux-mcp/v2@latest

# Or build from source
git clone https://github.com/MadAppGang/tmux-mcp
cd tmux-mcp && go build -o tmux-mcp .

Add to your MCP client config (~/.claude/settings.json for Claude Code):

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp",
      "args": ["--shell-type", "zsh"]
    }
  }
}

Get a terminal and run something in it — no setup call, no handle to carry:

// A pane beside the agent is created on first use. Synchronous: blocks until
// the command finishes, and returns output plus the exit code.
{"tool": "execute-command", "params": {"command": "go build ./..."}}
// → {"slot": 1, "created": true, "output": "", "exitCode": 0, "timedOut": false}

// The same slot is the same pane next time.
{"tool": "capture-pane", "params": {}}
// → the pane's text, with structuredContent {"slot": 1}

Why this exists

AI coding agents (Claude Code, Codex CLI, Gemini CLI, opencode) need terminal control. Existing MCP servers treat tmux as a dumb pipe: send a command, poll for output, repeat.

That model breaks down in four ways:

• An agent starts npm run dev and needs to know when the server is ready — not when it produced any output.
• An agent runs a database migration and needs to detect when psql is waiting for a password — not guess from screen text.
• An agent chains five operations and cannot afford a lookup round-trip between each step.
• An agent watches a build in a background pane while doing other work.

This project solves those four problems directly.

Comparison

ht-mcp is fast and dependency-free but works only with headless terminals it creates itself. It cannot attach to existing sessions or manage pane layouts.