tmux

Contrôle les sessions/panneaux tmux pour les CLIs interactifs : lister, capturer la sortie, envoyer des touches, coller du texte, surveiller les invites.

Qu'est-ce que tmux ?

Cette compétence permet à un agent IA de contrôler des sessions tmux existantes pour interagir avec des programmes en ligne de commande interactifs, idéal pour les processus longs comme les serveurs de développement ou les assistants CLI. Elle prend en charge la liste des sessions, fenêtres et panneaux, la capture du contenu des panneaux (y compris le défilement complet), l'envoi de texte littéral ou de touches spéciales (Ctrl-C, Ctrl-D, Escape), et la gestion des sessions (création, renommage, suppression). Elle fournit également des scripts utilitaires (find-sessions.sh, wait-for-text.sh) pour découvrir les sessions actives et attendre qu'un texte spécifique apparaisse dans la sortie d'un panneau. L'utilisation de marqueurs uniques (nonce) permet de détecter la fin de commandes asynchrones sans confusion, ce qui est crucial pour les workflows automatisés. Cette compétence est particulièrement utile avec Claude Code, Cursor ou d'autres agents qui doivent interagir avec des programmes interactifs tout en maintenant l'état de la session même après une déconnexion SSH.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawdbot/clawdbot/tree/main/skills/tmux

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait tmux ?

À utiliser pour les sessions tmux interactives existantes. Pour des commandes uniques, utilisez le shell normal. Pour de nouveaux travaux d'arrière-plan non interactifs, utilisez l'exécution en arrière-plan.

Bases

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 -

Format cible : session:window.pane, par ex. shared:0.0.

Envoyer une entrée

Texte littéral, puis Entrée :

tmux send-keys -t shared:0.0 -l -- "Veuillez continuer"
tmux send-keys -t shared:0.0 Enter

Touches spéciales :

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

Utilisez -l -- pour un texte arbitraire. Séparez le texte et Entrée pour éviter les surprises de collage/saut de ligne.

Sessions

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

Vérifications d'invites

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

Approuver/sélectionner uniquement lorsque l'invite est comprise :

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

Utilitaires

  • scripts/find-sessions.sh : découvrir les sessions.
  • scripts/wait-for-text.sh : attendre que le contenu du panneau capturé contienne un texte.

wait-for-text.sh recherche l'entrée renvoyée par écho et le défilement ainsi que la sortie du processus. Pour la fin de commande, utilisez un marqueur unique dont le texte complet est réparti sur plusieurs arguments dans la commande envoyée à 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

La commande renvoyée par écho ne contient jamais le marqueur complet, et le nonce empêche une ancienne ligne de fin de correspondre.

Remarques

  • capture-pane -p imprime sur la sortie standard pour les scripts.
  • -S - capture le défilement complet.
  • Les sessions tmux persistent même après une déconnexion 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, 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.

Skills associés