[DOCS] Ctrl+T "Toggle task list" is easily misread as the /tasks background-task view — and silently no-ops when the checklist is empty
Resolved 💬 0 comments Opened Jul 2, 2026 by domon-envato Closed Jul 2, 2026
Environment
- Claude Code v2.1.198 (native install), macOS (Darwin 24.6.0)
- No custom
~/.claude/keybindings.json
Summary
Three different features are called "task(s)" across the shortcut table and commands reference, and Ctrl+T gives no feedback when there is nothing to show. Together these make Ctrl+T look broken and make the shortcut row easy to misread:
Ctrl+T— "Toggle task list · Show or hide the task list in the terminal status area" (interactive-mode, General controls). This toggles Claude's to-do checklist — the bindable action isapp:toggleTodos, documented in keybindings as "Toggle task list visibility"./tasks(alias/bashes) — "view and manage everything running in the background" (commands).Ctrl+B— "Background running tasks" (same shortcut table).
What happened
- The spinner showed
✻ … · 1 shell still runningand I wanted to see that shell. - The shortcut row
Ctrl+T | Toggle task list | Show or hide the task list in the terminal status areareads, in that moment, like "the list of running tasks". - Pressing
Ctrl+Tdid nothing: the session had no checklist items, and the toggle renders nothing and gives no feedback when the checklist is empty — there is no way to tell the keypress even registered. This empty-list behavior is not documented. - Asking Claude inside Claude Code "how do I reveal the running shell?" reproduced the misreading: it quoted the docs row and pointed me at Ctrl+T for watching background work. Only after pushback did it land on the correct answer (
/tasks). This is the product-self-knowledge failure mode previously reported in #33059 (closed as not-planned/stale) and #18901 (closed as duplicate) — ambiguous docs get relayed as confidently wrong in-product answers.
Repro
- Start a session and don't let Claude create checklist items (no TaskCreate use).
- Run a long command in the background so the status area shows "1 shell still running".
- Press
Ctrl+T→ nothing happens, no feedback. - Have Claude create checklist items, press
Ctrl+Tagain → the checklist toggles, confirming the binding worked all along.
Suggested fixes
Any of these would have prevented the confusion:
- Docs: in the
Ctrl+Trow and the "Task list" section, disambiguate explicitly from background tasks, e.g. "Toggle Claude's task checklist (app:toggleTodos) — not the background-task view; use/tasksfor running shells/agents." Cross-references in both directions (Task list ↔ Background Bash commands //tasks) would help both human readers and Claude answering questions about itself. - Docs: document that the toggle shows nothing when the checklist is empty.
- Product: pressing
Ctrl+Twith an empty checklist could briefly show "No tasks in this session" instead of doing nothing. - Product (optional): a bindable action to open the
/tasksview (today it has noapp:*action in the keybindings reference).
Related
- #72823 requests rebinding Ctrl+T to character transposition — more evidence users don't discover what Ctrl+T currently does.
- #33059, #54646, #18901 — prior reports of Claude Code answering questions about its own features incorrectly; this issue is a concrete, fixable instance of the docs side of that problem.