К основному содержанию
плагин CX Codex

codex-tui-proof — плагин для Claude Code: TUI и установка

Плагин codex-tui-proof для Claude Code проверяет терминальные интерфейсы в браузере Codex: вводит клавиши и прикладывает скриншоты. Запускается по просьбе проверить TUI.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-tui-proof@awesome-codex-plugins
Открыть на GitHub

Что делает codex-tui-proof

Плагин codex-tui-proof поднимает локальный PTY, показывает его в браузере внутри Codex и проводит повторяемую проверку терминального интерфейса. Агент сверяет команду, рабочую папку, размеры окна и состояние сессии, затем выполняет клавиатурный сценарий, делает скриншот и сохраняет структурированные сведения. Рабочий стол при этом не управляется: Computer Use, Terminal.app, iTerm и автоматизация клавиатуры запрещены.

Для работы нужны приложение ChatGPT для компьютера с включённым плагином Browser, версия Codex CLI с командами codex plugin, а также Node.js 20 или новее и npm. При первом запуске npm устанавливает три закреплённые зависимости. Сервер и WebSocket слушают только 127.0.0.1, а запись сессии содержит ввод и вывод терминала, поэтому секреты в proof-сеанс вводить нельзя. Операторы shell, включая pipes и redirects, не поддерживаются.

Какие задачи решает

  • проверить внешний вид локального TUI в заданных размерах
  • пройти клавиатурный сценарий в терминальном интерфейсе
  • приложить скриншот и данные сессии к результату проверки
  • повторить сломанный поток ввода после исправления
  • сопоставить команду, рабочую папку и размеры PTY

Примеры запросов агенту

  • Проверь этот TUI в размерах 100x30 и приложи скриншоты через $validate-tui-in-codex.
  • Проверь палитру команд, выбери пункт и приложи подтверждение через $validate-tui-in-codex.
  • Воспроизведи сломанный поток клавиатуры, исправь его и повтори проверку через $validate-tui-in-codex.

Как установить codex-tui-proof

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-tui-proof@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codex-tui-proof

Как установить codex-tui-proof в Claude Code?

Выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install codex-tui-proof@awesome-codex-plugins.

Что делает codex-tui-proof?

Плагин запускает локальный PTY и открывает его в браузере Codex. Он выполняет клавиатурный сценарий, проверяет состояние сессии, снимает скриншот и выдаёт структурированные сведения о проверке.

Что нужно для работы codex-tui-proof?

Нужны приложение ChatGPT для компьютера с включённым Browser, Codex CLI с командами codex plugin, Node.js 20 или новее и npm.

Исходный текст

codex-tui-proof · MIT
# Codex TUI Proof

Visual validation for real terminal UIs, inside Codex, without taking over the desktop.

![Codex TUI Proof running OpenCode in the in-app browser](assets/opencode-final.png)

Codex TUI Proof launches a real local PTY, renders it in a deterministic browser terminal, and gives Codex a repeatable workflow for keyboard interaction, screenshots, and session evidence. It is built for developers shipping interactive CLIs and TUIs who want visual proof alongside code changes.

## Install

Requirements: the ChatGPT desktop app with the **Browser** plugin enabled, a Codex CLI release with `codex plugin` commands (verified with `0.144.2`), and Node.js 20 or newer with npm.

```sh
codex plugin marketplace add bnc4vk/codex-tui-proof
codex plugin add codex-tui-proof@codex-tui-proof
```

Start a new Codex task so the skill is loaded, then ask:

```text
$validate-tui-in-codex visually validate this TUI at 100x30 and attach screenshots.
```

The first proof installs three locked runtime dependencies locally. Later runs start immediately. The plugin has been tested on macOS; the runtime also handles Windows and Unix shells, with CI covering macOS, Windows, and Linux.

### Install from the desktop app

Open **Settings → Plugins**, choose **Add more**, and enter:

```text
https://github.com/bnc4vk/codex-tui-proof.git
```

Install **Codex TUI Proof** from that marketplace and start a new task.

## What Codex does

1. Starts the bundled localhost PTY bridge in the integrated terminal.
2. Opens the exact allocated `127.0.0.1` URL in Codex's in-app browser.
3. Checks command, working directory, terminal geometry, and session status.
4. Drives the requested keyboard flow and observes the resulting state.
5. Captures a controlled-tab screenshot plus structured session evidence.
6. Stops the local harness when validation is complete.

The workflow explicitly refuses to fall back to Computer Use, Terminal.app, iTerm, or desktop keyboard automation.

## Why not a headless TUI test?

Headless tools are excellent for assertions. Codex TUI Proof covers a different gap: a coding agent needs to see and interact with the rendered TUI while it works, then hand the developer reviewable visual evidence.

| Capability | Codex TUI Proof | Headless TUI test | Desktop automation |
|---|---:|---:|---:|
| Real local PTY | Yes | Varies | Yes |
| Visible in Codex | Yes | Usually no | Indirectly |
| Deterministic geometry | Yes | Yes | Varies |
| Screenshot evidence | Yes | Varies | Yes |
| Leaves desktop untouched | Yes | Yes | No |
| Structured session evidence | Yes | Varies | No |

This is not a new terminal emulator or a replacement for ttyd, shell-use, Termless, VirtUI, or VHS. See the [prior-art review](docs/prior-art.md) for the architecture decision.

## Agent-facing contract

The launcher emits one machine-readable readiness line:

```text
TUI_PROOF_READY {"url":"http://127.0.0.1:<port>","command":"...","cwd":"...","cols":100,"rows":30}
```

Codex uses that URL verbatim. Stable browser selectors and JSON endpoints expose status, dimensions, command, working directory, byte counts, and the local recording path. The full contract is in [evidence-contract.md](skills/validate-tui-in-codex/references/evidence-contract.md).

Useful prompts:

```text
$validate-tui-in-codex check the command palette, select an item, and attach proof.

$validate-tui-in-codex verify this resize fix at 80x24 and 120x40.

$validate-tui-in-codex reproduce the broken keyboard flow, fix it, and re-run the proof.
```

## Direct launcher and diagnostics

Codex normally runs these commands for you:

```sh
node scripts/tui-proof.mjs doctor

node scripts/tui-proof.mjs start \
  --command "opencode" \
  --cwd "/path/to/worktree" \
  --cols 100 \
  --rows 30 \
  --port 0
```

`--port 0` prevents collisions between concurrent tasks. Run `node scripts/tui-proof.mjs --help` for the complete launcher syntax.

Commands are parsed into an executable and arguments and are not interpolated into a shell command. On Windows, a fixed PowerShell bridge resolves executables while keeping the parsed arguments separate. Shell operators such as pipes and redirects are intentionally unsupported; put complex setup in a reviewed script and launch that script instead.

## Privacy and security

- The HTTP and WebSocket server bind only to `127.0.0.1`.
- There is no telemetry, account, hosted service, or remote data store.
- Session recordings include terminal input and output. Do not type secrets into a proof session.
- The target executable runs directly with the launcher's local user permissions and may access the network if it normally does.
- The first run contacts npm to install the three versions pinned in `runtime/package-lock.json`.

Read [PRIVACY.md](PRIVACY.md) and [SECURITY.md](SECURITY.md) before using the plugin with sensitive projects.

## Development

```sh
npm ci --prefix runtime
npm run check --prefix runtime
npm test --prefix runtime
```

Contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), and use [SECURITY.md](SECURITY.md) for vulnerability reports.

## License

[MIT](LICENSE) © 2026 Ben Cohen

© Ben Cohen · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Тесты и QA» →
tui-verify-change dominikmartn Скилл tui-verify-change для Claude Code запускает headless TUI Warp и читает отрисованный экран после изменений интерфейса, ввода или поведения. CX Codex +1 ★ 720звёзд репо tui-fundamentals JosiahSiegel Скилл tui-fundamentals для Claude Code помогает спроектировать TUI, выбрать фреймворк и проверить архитектуру терминального приложения. Описывает TUI для dashboard, REPL, wizard и интерактивного CLI. CX Codex +1 369установок tui-validate mikeyobrien Скилл tui-validate снимает скриншот терминального интерфейса через freeze и оценивает его по критериям с помощью LLM. Пригодится после правок в TUI, чтобы поймать сломанную вёрстку. CX Codex +1 ★ 3 206звёзд репо opentui msmps Скилл opentui для Claude Code помогает собирать терминальные интерфейсы на OpenTUI. Он подключается к задачам с компонентами, раскладкой, клавиатурой, анимацией и тестами. CX Codex +1 64 600установок tui-designer ckorhonen Скилл tui-designer для оформления терминальных интерфейсов в стиле ретро и киберпанк: CRT-эффекты, неоновое свечение, фосфорный зелёный экран. CX Codex +1 6установок CODE-1895-tui-lrc-typeahead-wiring dominikmartn CODE-1895-tui-lrc-typeahead-wiring — субагент для Claude Code, который возвращает набранный текст в TUI после завершения долгой команды. Срабатывает на shell-промпте после LRC. CX Codex ★ 720звёзд репо

Из того же набора391

Весь набор →
context-guard Плагин context-guard для Claude Code и Codex сохраняет требования и подтверждения в длинных задачах Codex. Он восстанавливает открытый список после сжатия контекста и проверяет доказательства выполнения. CX Codex ★ 1 596звёзд репо codex-attachment-manager Плагин codex-attachment-manager для Claude Code управляет историей изображений в задачах Codex. Он выбирает вложения для следующего сообщения и ищет их по описанию. CX Codex ★ 1 596звёзд репо codex-claude-council Плагин codex-claude-council задаёт вопрос одновременно Claude и ChatGPT через Codex. Модели спорят друг с другом раунд за раундом, пока не сойдутся на одном общем ответе. CX Codex ★ 1 596звёзд репо codex-usage-and-resets Плагин codex-usage-and-resets показывает расход недельного лимита Codex, темп использования и сроки сброса. Помогает оценить, хватит ли лимита на запланированную работу. CX Codex ★ 1 596звёзд репо codex-tasklist Плагин codex-tasklist создаёт живую панель задач для сессий Codex CLI с автосохранением в SQLite и переключением на tmux при отсутствии нативных панелей терминала. CX Codex ★ 1 596звёзд репо codex-skin-pack-installer Плагин codex-skin-pack-installer загружает и проверяет безопасные наборы скинов Codex из релизов GitHub. Он пригодится, когда нужны фон, оформление и понятный путь восстановления. CX Codex ★ 1 596звёзд репо codex-rg-guard Плагин codex-rg-guard для Claude Code сужает широкие поисковые запросы через бюджетный MCP-инструмент. Он отбирает файлы и ограничивает выдачу строк. CX Codex ★ 1 596звёзд репо codex-reviewer Плагин codex-reviewer проводит независимое ревью планов и написанного кода в проектах под управлением Claude. Помогает находить логические дыры до мёржа. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой