liaohch3/claude-tap

Claude Tap E2E Test runs the claude-tap end-to-end test suite with pytest to validate core proxy logic, trace writing, viewer streaming, signal handling, and startup behavior after modifying core code.

Codex E2E Test runs PR-grade real Codex E2E validation through claude-tap, including resume turns, multiple tool calls, optional image input, viewer verification, and screenshot evidence. Use it for every PR that changes capture, proxying, viewer rendering, or trace behavior.

Demo Video Generation records terminal sessions in tmux with asciinema and converts them to GIF and MP4 demo assets, then captures viewer screenshots via Playwright for documentation. Use it to create realistic demos from real E2E runs and UI views.

JS in HTML Testing verifies JavaScript embedded in HTML files using a two-layer strategy: Python unit tests for pure logic and Playwright browser tests for DOM interaction. Use it to test embedded scripts without full end-to-end runs.

Legibility Check runs deterministic checks on maintainer docs to catch stale standards metadata, broken architecture manifest paths, and plan state drift before CI does. Use it after modifying files under .agents/docs/standards/, .agents/docs/plans/, .agents/docs/architecture/, or AGENTS.md.

PR Preflight runs a full merge-readiness check before opening or merging a pull request, validating local gates (lint, format, tests), CI status, screenshot evidence, and PR metadata in one pass.

Playwright Screen Recording captures headless browser test sessions as .webm video files for PR review, bug fix verification, and regression evidence. Use it when you need visual proof of UI behavior changes alongside terminal logs.

Push Release pushes code to GitHub and bumps the version when pending commits include feature changes so CI auto-publishes to PyPI. Use it to deploy Python packages and confirm release status.

Real E2E Test runs real end-to-end tests that start claude-tap from local source, connect to the real Claude CLI, and verify trace output. Use it to validate pytest and tmux interactions, tool use, HTML viewer generation, and API key redaction.

Screenshot Validation checks evidence images and viewer HTML files for quality standards before committing, catching issues like small or blank screenshots and viewer rendering errors. Use it after generating PR evidence or new trace viewer HTML.

Translate i18n fills missing i18n translations in the viewer source JSON, using English and Chinese as source languages to auto-translate to Japanese, Korean, French, Arabic, German, and Russian via OpenRouter. Use it after adding or modifying UI strings in claude_tap/viewer_i18n.json.