菜单
Manage long-running terminal jobs in a dedicated tmux-opencode session using wrapper scripts for run/wait, health checks, and crash-recovery cleanup.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tmux |
| description | Manage long-running terminal jobs in a dedicated tmux-opencode session using wrapper scripts for run/wait, health checks, and crash-recovery cleanup. |
| references | ["references/operations.md"] |
Use tmux to run background jobs while continuing other work. Keep all skill-managed windows in one session, tmux-opencode, so inspection and cleanup happen in one place. Default to wrapper scripts over manual command chaining. Do not block by default; opt in to blocking wait only when requested.
Confirm tmux availability before using this skill.
tmux -V
If tmux is unavailable, run commands in the foreground.
Standardize on a single session.
SESSION="tmux-opencode"
tmux new-session -d -s "$SESSION" -n "main" 2>/dev/null || true
tmux list-windows -t "$SESSION"
scripts/tmux_run_job.py auto-creates this session when missing.
Install managed cron cleanup once per machine/user.
python3 scripts/tmux_healthcheck_cron.py --action install
Verify installation.
python3 scripts/tmux_healthcheck_cron.py --action status
Run a command in the background (default behavior).
python3 scripts/tmux_run_job.py --command "npm start"
Run in a named window (auto-normalized to oc-*).
python3 scripts/tmux_run_job.py --window server --command "npm start"
Block until completion only when requested.
python3 scripts/tmux_run_job.py --window build --command "npm run build" --wait
Wait later for an already-started job by target.
python3 scripts/tmux_run_job.py --wait-target "tmux-opencode:oc-build"
Use wait timeout when blocking behavior needs a guardrail.
python3 scripts/tmux_run_job.py --window build --command "npm run build" --wait --wait-timeout-seconds 1800
Auto-close successful windows when waiting.
python3 scripts/tmux_run_job.py --window lint --command "npm run lint" --wait --close-window success
Capture visible output.
tmux capture-pane -p -t "tmux-opencode:oc-server"
Capture full scrollback.
tmux capture-pane -p -S - -t "tmux-opencode:oc-server"
Interrupt a running command.
tmux send-keys -t "tmux-opencode:oc-server" C-c
Kill one window.
tmux kill-window -t "tmux-opencode:oc-server"
Show window health (idle minutes, active state).
python3 scripts/tmux_healthcheck.py
Dry-run stale window cleanup.
python3 scripts/tmux_healthcheck.py --cleanup --max-idle-minutes 240 --dry-run
Run cleanup for stale windows and legacy sessions after interruptions or crashes.
python3 scripts/tmux_healthcheck.py --cleanup --max-idle-minutes 240 --cleanup-legacy-sessions
Install or update automatic periodic cleanup cron (idempotent managed entry).
python3 scripts/tmux_healthcheck_cron.py --action install
Preview cron line without writing.
python3 scripts/tmux_healthcheck_cron.py --action install --dry-run
Check installed cron status.
python3 scripts/tmux_healthcheck_cron.py --action status
Remove the managed cron entry.
python3 scripts/tmux_healthcheck_cron.py --action remove
scripts/tmux_run_job.py (background by default).tmux capture-pane when needed.--wait for immediate blocking, or --wait-target for wait-after-start.scripts/tmux_healthcheck.py --cleanup periodically or at session end.scripts/tmux_healthcheck_cron.py --action install for automatic recovery cleanup.Build a fast, actionable branch/PR/commit context pack with scope, intent, changed files, hotspots, risks, and next actions. Use before handing work to another agent, reviewing a branch, resuming unfamiliar work, or preparing a PR/code-review prompt.
Create reviewed Codex goal setup packages for long-running /goal work. Use when the user wants to turn an idea, backlog, project mission, or vague objective into durable goal files under a project goals slug folder, with Plannotator review gates for brief, narrative plan with acceptance criteria, verification, blockers, and the final /goal prompt.
User guide for the local squash-safe `stack` CLI for stacked PR repair. Use when someone asks how to inspect, track, sync, merge, repair, document, or undo stacked pull requests in squash-merge repositories. Prefer this tool over GitHub's `gh stack` command for this workflow.
Video understanding and transcription with intelligent multi-provider fallback. Use when: (1) Transcribing video or audio content, (2) Understanding video content including visual elements and scenes, (3) Analyzing YouTube videos by URL, (4) Extracting information from local video files, (5) Getting timestamps, summaries, or answering questions about video content. Automatically selects the best available provider based on configured API keys - prefers full video understanding (Gemini/OpenRouter) over ASR-only providers. Supports model selection per provider.
Designs and refactors React component APIs toward compound composition: fewer boolean mode props, clearer seams, context-backed internals, and JSX-first variant assembly. Use when building or reviewing React components with many props, conditional render branches, render props/slots, shared form/composer/card/table internals, or when the user mentions composition, compound components, Radix-style APIs, prop drilling, boolean props, or "composition is all you need".
Generate professional dark-themed system architecture diagrams as standalone HTML/SVG files. Self-contained output with no external dependencies. Based on Cocoon AI's architecture-diagram-generator (MIT).