# APP-4903 improve TUI tab bar keybindings

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/app-4903-improve-tui-tab-bar-keybindings

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/APP-4903-improve-TUI-tab-bar-keybindings.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/APP-4903-improve-TUI-tab-bar-keybindings.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/APP-4903-improve-TUI-tab-bar-keybindings.md` — Cursor also reads .claude/agents/

## When to use it
- 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
- 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.

## Similar
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs
- [codex-tui-proof](https://affpapa.org/en/nevibecode/plugins/codex-tui-proof.md) — plugin · ★ 1596 repo stars
- [textual-tui-skill](https://affpapa.org/en/nevibecode/skills/textual-tui-skill.md) — skill · 268 installs
- [tui-design](https://affpapa.org/en/nevibecode/skills/tui-design.md) — skill · 1400 installs
- [tui-fundamentals](https://affpapa.org/en/nevibecode/skills/tui-fundamentals.md) — skill · 369 installs
- [tui-validate](https://affpapa.org/en/nevibecode/skills/tui-validate.md) — skill · ★ 3206 repo stars

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
