# Tmux Test

> Test klaude-code interactively using tmux with synchronous task completion. Use when testing UI features, verifying changes, or debugging interactive behavior. Eliminates polling/sleep by using KLAUDE_TEST_SIGNAL for precise synchronization.

- Skill: `majiayu000/tmux-test` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/tmux-test`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/tmux-test/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/tmux-test

---


# tmux-test

Test klaude-code in an interactive tmux session with synchronous task completion.

## Quick Start

```bash
# Create session and start klaude with signal
tmux new-session -d -s test -x 120 -y 30
tmux send-keys -t test 'KLAUDE_TEST_SIGNAL=done uv run klaude' Enter
sleep 3  # Wait for startup only

# Send request and wait for completion (no polling needed)
tmux send-keys -t test 'your prompt here' Enter
tmux wait-for done  # Blocks until task completes

# Capture output
tmux capture-pane -t test -p -S -50

# Cleanup
tmux kill-session -t test
```

## Key Points

- `KLAUDE_TEST_SIGNAL=<channel>`: Environment variable that enables task completion signaling
- `tmux wait-for <channel>`: Blocks until the signal is sent (task completes)
- Signal is only sent when main agent task finishes (not sub-agents)
- Use `-S -N` with capture-pane to get N lines of scrollback history

## Common Patterns

### Multiple Sequential Requests

```bash
for prompt in "request 1" "request 2"; do
  tmux send-keys -t test "$prompt" Enter
  tmux wait-for done
  tmux capture-pane -t test -p -S -30
done
```

### Capture Full Output

```bash
tmux capture-pane -t test -p -S -  # Entire scrollback
```