Tui And Desktop

---
name: tui-and-desktop
description: "Router for terminal chat presentation, OpenTUI host behavior,
  plain fallback, Web UI presentation, and desktop packaging/runtime."
metadata:
  disco-role: operating
disable-model-invocation: true
license: Apache 2.0
---

# TUI and Desktop

Use this sub-skill for the user-facing surface family: terminal chat, OpenTUI
host behavior, the Web UI control console, artifact previews, and the packaged
desktop shell.

## Route elsewhere
- Setup/install, gateway lifecycle, and release vs source installation choices
  → `setup-and-gateway`
- Provider/search/router/config issues surfaced in the UI →
  `configuration-and-routing`
- Chat/session automation without a UI focus → `cli-and-automation`
- Channels and MCP → `channels-and-integrations`
- Skill catalogs and meta-skills → `skills-and-meta`

## Covers
- `opensquilla chat --ui auto|tui|plain`
- OpenTUI source-development override and companion-host behavior
- Terminal resize, alternate-screen, and host crash recovery
- Web UI presentation, artifacts, deliverables, and preview behavior
- Desktop packaging/runtime and launch semantics

## Use these references
- `references/commands.md`
- `references/runtime-and-packaging.md`
- `references/artifact-previews.md`
- `references/troubleshooting.md`

## Safe helper
- `scripts/smoke_tui_host_companion.py` — tiny bridge smoke for an installed
  or source-host TUI companion

## Verification anchors
- `tests/test_cli/test_tui_meta_command.py`
- `tests/test_cli/test_help_theme.py`
- `tests/test_desktop/test_electron_startup_contract.py`
- `tests/functional/test_webui_browser_e2e.py`
- `opensquilla-webui/e2e/chat.spec.ts`
- `opensquilla-webui/e2e/artifact-card.spec.ts`
- `opensquilla-webui/e2e/artifact-preview.spec.ts`
- `opensquilla-webui/e2e/preview-origin-csp.spec.ts`
- `opensquilla-webui/e2e/session-drawer.spec.ts`
- `opensquilla-webui/e2e/settings-modal.spec.ts`
- `opensquilla-webui/e2e/workbench.spec.ts`
- `desktop/electron/scripts/test-native-workbench-surface.mjs`
- `desktop/electron/scripts/test-desktop-gateway-lifecycle.mjs`
- `desktop/electron/scripts/test-cli-invocation.mjs`

## Notes
- Keep provider/router/search questions out of this sub-skill unless the issue
  is visibly caused by a UI surface.
- Keep non-UI chat/session workflows out of this sub-skill unless the launch,
  renderer, or packaging behavior is the question.