Skip to content
Get packs

tmux Real User Testing

Drive Qwen Code's terminal UI in tmux like a real user and save a readable step-by-step test log

Source Download skill
Repository
QwenLM/qwen-code
Stars
28,880
Licence
Apache-2.0
Files
2 files

What it does

When installed, the agent runs Qwen Code inside a tmux terminal session, presses keys the way a person would (typing slash commands, arrowing through dialogs, confirming choices), and takes text snapshots of the screen after each step. These snapshots are saved into a timestamped folder as a readable transcript that a maintainer can review later, along with a short pass/fail report. It is aimed at checking the interactive terminal experience rather than just the final result.

Great for

  • Maintainers of Qwen Code who want a readable record of how a dialog or slash command behaved on screen
  • Developers reproducing a terminal UI bug and needing evidence of each intermediate screen
  • Teams doing regression testing of flows such as /auth, /model, or MCP setup

Skip it if

  • Simple pass/fail checks of tool execution or model API output, where the headless JSON test approach is more suitable
  • Running against a real account or production credentials without care, since the flows may trigger logins, browser windows, and config changes that persist between runs

Try asking

  • “Test the /auth dialog end to end in tmux and save a readable log of each screen”
  • “Run a tmux real-user test of the /model and /manage-models flow and write a report.md with the result”
  • “Capture the screens during slash command interaction and tell me where the display glitches”
Step-by-step guide: how to use tmux Real User TestingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the Apache-2.0 licence and an attribution note.

    tmux-real-user-testing.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip tmux-real-user-testing.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip tmux-real-user-testing.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run it from the root of the Qwen Code repository so the tmp/ output folder and script paths resolve correctly.
  • Review the scripts/tmux-real-user-log.sh file and any side effects (settings changes, opened browser windows, API calls) before running flows like /auth on a machine with real accounts.
  • Ask for a specific scenario with clear steps and expected text so the wait conditions match what the app actually prints.

What's inside

  • scripts/tmux-real-user-log.sh
  • SKILL.md

Redistributed unmodified from QwenLM/qwen-code under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.