Community코딩 & 개발github.com

tmux

대화형 CLI를 위한 tmux 세션/창 제어: 목록 보기, 출력 캡처, 키 전송, 텍스트 붙여넣기, 프롬프트 모니터링.

tmux란 무엇인가요?

이 스킬은 AI 에이전트가 기존 tmux 세션과 상호작용할 수 있도록 지원하는 도구입니다. 터미널 멀티플렉서인 tmux의 세션, 윈도우, 팬을 제어하여 명령어 전송, 출력 캡처, 프롬프트 모니터링 등 다양한 작업을 수행할 수 있습니다. Claude Code, Cursor, Codex 등 여러 AI 에이전트 플랫폼에서 사용 가능하며, SSH 연결이 끊어져도 세션이 유지되는 tmux의 특성을 활용하여 장기 실행 작업이나 원격 서버 관리에 특히 유용합니다. `send-keys`로 키 입력을 전송하고, `capture-pane`으로 출력을 가져오며, `wait-for-text.sh`와 같은 헬퍼 스크립트를 통해 특정 텍스트가 나타날 때까지 기다리는 등 세밀한 제어가 가능합니다. 또한 임의의 논스(nonce)를 포함한 마커를 사용하여 명령 완료를 정확히 감지할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawdbot/clawdbot/tree/main/skills/tmux

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

tmux은(는) 무엇을 하나요?

기존 대화형 tmux 세션에 사용합니다. 일회성 명령에는 일반 셸을 사용하세요. 새로운 비대화형 백그라운드 작업에는 백그라운드 실행을 사용하세요.

기본

tmux ls
tmux list-windows -t shared
tmux list-panes -t shared:0
tmux capture-pane -t shared:0.0 -p
tmux capture-pane -t shared:0.0 -p -S -

형식: 세션:윈도우.팬, 예: shared:0.0.

입력 전송

리터럴 텍스트, Enter:

tmux send-keys -t shared:0.0 -l -- "Please continue"
tmux send-keys -t shared:0.0 Enter

특수 키:

tmux send-keys -t shared:0.0 C-c
tmux send-keys -t shared:0.0 C-d
tmux send-keys -t shared:0.0 Escape

임의의 텍스트에는 -l --를 사용하세요. 텍스트와 Enter를 분리하여 붙여넣기/개행 문제를 피하세요.

세션

tmux new-session -d -s worker
tmux rename-session -t old new
tmux kill-session -t worker

프롬프트 확인

tmux capture-pane -t worker-3 -p | tail -20
tmux capture-pane -t worker-3 -p | rg "proceed|permission|Yes|No|❯"

프롬프트가 이해되었을 때만 승인/선택:

tmux send-keys -t worker-3 -l -- "y"
tmux send-keys -t worker-3 Enter

헬퍼

  • scripts/find-sessions.sh: 세션 발견.
  • scripts/wait-for-text.sh: 캡처된 팬 내용에 텍스트가 포함될 때까지 대기.

wait-for-text.sh는 프로세스 출력뿐만 아니라 에코된 입력과 스크롤백도 검색합니다. 명령 완료를 확인하려면 tmux로 전송된 명령에서 인수로 분할된 전체 텍스트를 가진 고유 마커를 사용하세요.

nonce="$(od -An -N8 -tx1 /dev/urandom | tr -d ' \n')"
marker="OPENCLAW_DONE_${nonce}"
tmux send-keys -t shared:0.0 -l -- "sleep 4; printf '%s%s\n' 'OPENCLAW_DONE_' '$nonce'"
tmux send-keys -t shared:0.0 Enter
scripts/wait-for-text.sh -t shared:0.0 -p "$marker" -F -T 30

에코된 명령에는 완전한 마커가 포함되지 않으며, 논스는 이전 완료 라인이 일치하는 것을 방지합니다.

참고

  • capture-pane -p는 스크립트용으로 stdout에 출력합니다.
  • -S -는 전체 스크롤백을 캡처합니다.
  • tmux 세션은 SSH 연결 끊김에도 유지됩니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

1password

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

acp-router

Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Grok Build, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation. Codex chat binding defaults to the native Codex app-server plugin unless ACP is explicit or background spawn needs ACP.

add-model-provider

Add and live-prove a model provider with non-interactive config one-liners, without exposing credentials.

agent-transcript

Requested GitHub PR/issue agent transcripts: redact, trim, preview, and insert safely.

apple-notes

Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS.

apple-reminders

List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl.

auto-qa

Run OpenClaw-wide autonomous QA and live/stress campaigns across independent subsystem lanes, with verified fixes and a resumable evidence report.

autoreview

Structured code review through the shared OpenClaw agent-skills installation.

bear-notes

Create, search, and manage Bear notes via grizzly CLI.

blacksmith-testbox

Run Blacksmith Testbox for CI-parity checks, secrets, hosted services, migrations, or builds local cannot reproduce.

block-kit

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

blogwatcher

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

browser-automation

Use when controlling web pages with the OpenClaw browser tool, especially multi-step flows, login checks, tab management, or recovery from stale refs/timeouts.

camsnap

Capture frames or clips from RTSP/ONVIF cameras and local webcams, including USB pan/tilt/zoom control.

canvas

Present HTML on connected OpenClaw node canvases, navigate/eval/snapshot, and debug canvas host URLs.

channel-message-flows

Use when running QA Lab channel message flow evidence.

clawdtributor

Clawtributor PRs here, last week or another window: discover conversation refs, recheck GitHub, rank by impact.

clawhub

Search ClawHub for plugins by default, or skills when explicitly requested; install, verify, update, uninstall, publish, or sync skills.

관련 스킬