console-tui git:20261004.4bb7222A

Immutable. This exact content never changes and is served at /api/v1/blob/84e588b7b507e37a.

---
description: Console TUI rendering, local shell, and question behavior
globs:
  - "external/cli/**/*.go"
  - "internal/tools/shell/operator.go"
  - "examples/cli/**/*.py"
  - "features/cli*.feature"
  - "docs/surfaces/console.md"
alwaysApply: false
---
# Console TUI behavior

- The same backing slice and length returned from `Render` means unchanged. Stable components must not return fresh equal slices.
- Never mutate component-owned rendered slices during frame decoration. Invalidate or release caches on Clear, child removal, width changes, and zero-child transitions; test A -> A -> B at terminal output.
- `!!` stays local and remote-disabled. It uses no permission gate, session, or task pool, is not persisted, and is invisible to the model.
- Only the question modal uses `DescriptionBelow`; other selectors keep the default layout. Completed question tools render question and answer pairs through `questionReadout`, not raw JSON.
- TUI question stubs emit the real tool-call lifecycle.
- Never pass a real repository as `CoddyTUI.workdir`, because driver cleanup deletes home and workdir. Use temporary copies or `keep_dirs`.