Context Vault

smux - tmux 터미널 자동화 및 에이전트 간 통신

6 min read

smux - tmux 터미널 자동화 및 에이전트 간 통신

원커맨드 tmux 설정 + 에이전트 간 통신을 위한 tmux-bridge CLI. AI 에이전트용 터미널 자동화 솔루션입니다.

개요

smux는 tmux를 위한 설정과 tmux-bridge CLI를 제공하는 오픈소스 프로젝트입니다.

  • 사용자 용: Option 키 바인딩, 마우스 지원, 팬 라벨이 있는 키보드 주도 tmux 설정
  • 에이전트 용: tmux-bridge CLI가 어떤 에이전트든 팬을 읽고, 타이핑하고, 키를 보낼 수 있게 함
  • 에이전트 간: Claude Code가 다음 팬에서 Codex를 프롬프트하고, Codex가 응답할 수 있음. bash를 실행할 수 있는 모든 에이전트가 참여 가능

GitHub: https://github.com/ShawnPana/smux 라이선스: (GitHub 페이지에서 확인 필요)

빠른 시작

curl -fsSL https://shawnpana.com/smux/install.sh | bash

설치 대상:

  • tmux가 설치되어 있지 않으면 설치됨 (Homebrew, apt, dnf, pacman, apk 통해)
  • tmux.conf — Option 키 바인딩, 마우스 지원, 팬 라벨, 최소한 상태 바 포함
  • tmux-bridge CLI — 팬 간 교차 에이전트 통신

모든 것은 ~/.smux/에 저장됩니다.

키 바인딩

네비게이션 (no wrap)

키액션
Option + i/k/j/l위/왼/아래/오른쪽 팬으로 이동

팬 관리

키액션
Option + n새 팬 (분할 + 자동 타일)
Option + w팬 닫기
Option + o레이아웃 순환
Option + g팬 마크
Option + y마크된 팬과 교환

윈도우 관리

키액션
Option + m새 윈도우
Option + u다음 윈도우
Option + h이전 윈도우

스크롤 모드

키액션
Option + Tab스크롤 모드 토글
i/k위/아래로 스크롤
Shift + I/K반 페이지 위/아래로
q 또는 Escape스크롤 모드 종료

마우스

  • 클릭으로 팬 선택
  • 드래그로 텍스트 선택 (자동 클립보드로 복사)
  • 스크롤 휠로 스크롤

참고: 모든 키바인딩은 Option (Alt) 키를 사용하며 프리픽스가 필요 없습니다.

tmux-bridge CLI

bash를 실행할 수 있는 모든 도구가 사용할 수 있습니다 — Claude Code, Codex CLI, Gemini CLI, 또는 일반 셸 스크립트.

명령설명
tmux-bridge list모든 팬을 대상, 프로세스, 라벨과 함께 표시
tmux-bridge read <target> [lines]팬에서 마지막 N 줄 읽기
tmux-bridge type <target> <text>팬에 텍스트 입력 (Enter 없음)
tmux-bridge keys <target> <key>...키 전송 (Enter, Escape, C-c 등)
tmux-bridge name <target> <label>쉬운 주소를 위해 팬에 라벨 지정
tmux-bridge resolve <label>라벨로 팬 찾기
tmux-bridge id이 팬의 ID 출력

예시:

tmux-bridge list          # 모든 팬 표시
tmux-bridge read codex 20 # 팬에서 마지막 20줄 읽기
tmux-bridge type codex "review src/auth.ts"  # 타이핑
tmux-bridge keys codex Enter   # Enter 키 누르기

자세한 문서는 smux skill을 참조하세요.

설치된 컴포넌트

tmux (자동 설치)

지원되는 패키지 매니저:

  • macOS — Homebrew 필요
  • Linux — apt, dnf, pacman, apk 지원

필요 버전: tmux 3.2+

smux 스킬

에이전트가 tmux-bridge를 사용하는 방법을 가르치기 위해 smux 스킬을 설치하세요:

npx skills add ShawnPana/smux

호환되는 에이전트:

사용 사례: 에이전트 간 통신

Claude Code가 Codex 팬에 메시지를 보내고 응답을 받을 수 있습니다:

# Claude Code 팬에서 Codex에게 보내기
tmux-bridge type codex "Help me refactor this function"
tmux-bridge keys codex Enter
 
# Codex 팬에서 읽기
tmux-bridge read codex 30

기타 명령

명령설명
smux updatesmux 업데이트
smux uninstallsmux 설치 제거

특징 요약

사용자 용

  • ⌨️ Option 키 바인딩 — 프리픽스 없음
  • 🖱️ 마우스 지원 — 클릭으로 팬 선택, 드래그로 복사
  • 🏷️ 팬 라벨 — 쉬운 주소
  • 📊 최소한 상태 바

에이전트 용

  • 🤖 tmux-bridge CLI — 모든 에이전트에서 접근 가능
  • 💬 에이전트 간 통신 — Claude Code → Codex, 또는 그 반대
  • 🔄 자동화 — 팬 간 텍스트, 키 전송

관련

요약

smux는 tmux를 더 쉽게 사용하게 하고, AI 에이전트가 서로 통신할 수 있게 합니다. 하나의 커맨드로 설치하고, Option 키 바인딩으로 빠르게 이동하고, tmux-bridge로 에이전트 간 협업을 자동화하세요.

Source: GitHub (2026-03-29)

그래프 뷰