claude agents TUI: ←-to-detach is undiscoverable, mode-dependent (empty input only), and Esc interrupts instead of going back
Open 💬 0 comments Opened Jul 13, 2026 by mykolaxboiko
Environment
- Claude Code v2.1.207, macOS (Darwin 25.5.0),
claude agentsdashboard (agent view)
Problem
In the claude agents TUI, the key to detach from a session and return to the session list is the left arrow — but only when the message input box is empty. If any text has been typed, the same key silently switches roles and moves the text cursor instead.
This makes the single most common navigation action (going back to the list) effectively undiscoverable:
- There is no on-screen hint that ← detaches, and no indication of which "mode" the key is currently in (navigate vs. edit text).
- A user who has typed even one character gets no feedback about why ← "stopped working" — it just behaves as a text-editing key.
Esc— the key most users try first for "go back" — instead interrupts the running agent, which is a destructive surprise in this context.- The only in-product documentation of these bindings that a new user is likely to encounter is... asking the agent itself, or
?(which is itself undocumented on screen).
Real-world result: a user attached to a background session could not figure out how to get back to the dashboard, and had to ask the model inside the session to explain the UI to them.
Suggestions (any subset would help)
- Show a persistent one-line key hint in the dashboard/session footer (
← back · → attach · Space peek · Ctrl+X stop · ? help), like lazygit/k9s do. - Add an unambiguous detach binding that never collides with text editing (e.g.
Ctrl+Q, or makeEscon an empty input detach instead of no-op). - When ← is pressed with a non-empty input, flash a hint ("clear input to go back, or press <key>").
Steps to reproduce
claude agents, attach to any session with →- Type a character into the input box
- Press ← repeatedly: cursor moves, nothing hints the navigation function exists
- Press Esc: interrupts the agent instead of going back