APP-4903 improve TUI tab bar keybindings — Claude Code subagent
APP-4903 improve TUI tab bar keybindings is a Claude Code subagent for orchestration TUI focus. It changes Down and Escape behavior and checks the related regressions.
AGPL-3.0 ★ 720 updated 2026-11-10
.claude/agents/APP-4903-improve-TUI-tab-bar-keybindings.mdWhat APP-4903 improve TUI tab bar keybindings does
APP-4903 improve TUI tab bar keybindings updates keyboard handling for orchestration tabs in a terminal UI. Down moves focus back to the session input while Shift+Down remains available. Escape selects the configured main session and focuses its input; when that session is already selected, Escape only restores input focus.
The change covers terminal_session_view.rs, tab_bar.rs, and orchestration_tab_bar.rs, along with regression coverage for bindings, session selection, focus ownership, and footer text. The focused footer shows ↓, with no Shift + ↓ or Escape hint. Down and Escape are scoped to the tab-focused context, leaving ordinary editor Down behavior unchanged.
Validation includes cargo test -p warp_tui, ./script/presubmit, and a live orchestration-tab flow. The test path exercises both a child session and the main session. The ORCHESTRATION_TAB_BAR_FOCUSED_FLAG context is required so an input-editor binding does not shadow Down.
What it helps with
- return focus from the tab bar to the session input
- send a child session back to the configured main session with Escape
- retain Shift+Down as a focus-input alias
- verify footer hints and binding scope
- run the focused TUI suite and presubmit
Example prompts for the agent
- Implement APP-4903 for the orchestration tab bar and add the required regression tests.
- Check that Down and Shift+Down focus the session input only when the tab bar has focus.
- Exercise Escape from a child tab and from the main tab, then update the footer assertion.
How to install APP-4903 improve TUI tab bar keybindings
Manually: put the files in place
.claude/agents/APP-4903-improve-TUI-tab-bar-keybindings.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/APP-4903-improve-TUI-tab-bar-keybindings.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/APP-4903-improve-TUI-tab-bar-keybindings.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about APP-4903 improve TUI tab bar keybindings
How do I install APP-4903 improve TUI tab bar keybindings in Claude Code?
Place the subagent file at .claude/agents/APP-4903-improve-TUI-tab-bar-keybindings.md.
What does APP-4903 improve TUI tab bar keybindings do?
It changes orchestration-tab focus handling. Down and Shift+Down return focus to the session input, while Escape selects the main session or restores its input focus.
What checks does APP-4903 improve TUI tab bar keybindings require?
Run cargo test -p warp_tui and ./script/presubmit, then exercise the live tab flow. Coverage includes child and main sessions, footer text, focus ownership, and binding scope.