# APP-4881-tui-starting-shell-indicator

APP-4881-tui-starting-shell-indicator is a Claude Code subagent that specifies the Starting shell... status line in TUI. It keeps the draft editor editable during initial session bootstrap.

- 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
- Source: https://github.com/dominikmartn/harp/tree/HEAD/agents/specs/APP-4881-tui-starting-shell-indicator.md
- 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-4881-tui-starting-shell-indicator

## What it does

This subagent formalizes TUI behavior during the shell initialization window before bootstrap completes. While the shell starts, the interface draws the prompt editor alongside a single `Starting shell...` line positioned directly above the input frame. Keystrokes accumulate safely without submitting on `Enter`, keeping the typed text intact once the prompt turns interactive.

Silent startup scripts execute without causing UI flicker. Whenever a startup script emits visible output requiring user interaction, focus routes straight to the PTY. The specification strictly excludes regular long-running commands like `tail` or alternate-screen programs, where the prompt editor remains hidden.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/APP-4881-tui-starting-shell-indicator.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-4881-tui-starting-shell-indicator.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-4881-tui-starting-shell-indicator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/agents/specs/APP-4881-tui-starting-shell-indicator.md

## When to use it
- render prompt draft editor before shell bootstrap finishes
- display the Starting shell... indicator status line in TUI
- block Enter submissions during session startup
- preserve typed command drafts across the bootstrap transition

## Example prompts
- Implement the Starting shell... status line according to spec APP-4881
- Verify draft input preservation during TUI session bootstrap

## Similar
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs
- [tui-design](https://affpapa.org/en/nevibecode/skills/tui-design.md) — skill · 1400 installs
- [codex-tui-proof](https://affpapa.org/en/nevibecode/plugins/codex-tui-proof.md) — plugin · ★ 1596 repo stars
- [create-agent-tui](https://affpapa.org/en/nevibecode/skills/create-agent-tui.md) — skill · 358 installs
- [tui-validate](https://affpapa.org/en/nevibecode/skills/tui-validate.md) — skill · ★ 3206 repo stars
- [tui-debug-in-pane](https://affpapa.org/en/nevibecode/skills/tui-debug-in-pane.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
