docs(web-shell): add real-scenario screenshots for the tmux terminal

Web Shell session showing the agent-created terminal task, and the same tmux session attached and running Claude Code live.
wenshao · Aug 5, 2026 · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026
commit 5580cbcf599c20bd907fbcd8af6eed6996b2533c
diff --git a/docs/design/assets/web-shell-tmux-terminal/terminal-claude.png b/docs/design/assets/web-shell-tmux-terminal/terminal-claude.png
diff --git a/docs/design/assets/web-shell-tmux-terminal/webshell-session.png b/docs/design/assets/web-shell-tmux-terminal/webshell-session.png
diff --git a/docs/design/web-shell-tmux-terminal.md b/docs/design/web-shell-tmux-terminal.md
@@ -1,5 +1,20 @@
 # Web Shell tmux Terminal (Interactive CLI Sub-Agent)
 
+## Real scenario
+
+The agent (in the Web Shell) is asked to start an interactive CLI; it uses the
+`tmux` tool, which registers a terminal task. The user can then attach and
+watch the live session.
+
+Web Shell session after the agent created the terminal (`bg_25154e98`):
+
+![Web Shell session showing the tmux tool call](./assets/web-shell-tmux-terminal/webshell-session.png)
+
+The same terminal attached (`tmux -L qwen-serve attach -t qsh-bg_25154e98`),
+running Claude Code live:
+
+![Attached tmux terminal running Claude Code](./assets/web-shell-tmux-terminal/terminal-claude.png)
+
 ## Problem
 
 A Web Shell session's agent already runs as a full qwen-code process on the