test-t3-app

Launch and test the T3 Code web app in isolated development environments.

6|6|Updated Aug 7, 2026
One-click install
npx skills add https://github.com/NateBJones-Projects/unlock-ai-workbench --skill test-t3-app-natebjones-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-t3-app
Source: https://github.com/NateBJones-Projects/unlock-ai-workbench/tree/main/.agents/skills/test-t3-app
Command: npx skills add https://github.com/NateBJones-Projects/unlock-ai-workbench --skill test-t3-app-natebjones-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running and iteratively testing the T3 Code web app locally is error-prone: dev servers die between turns, one-time pairing tokens get consumed accidentally, and shared state directories get corrupted. This Skill manages the full lifecycle of isolated T3 test environments so browser-based UI testing stays reproducible. ## Core Features & Use Cases - Isolated environment launch: Start the full web stack with worktree-local or temporary base directories, keeping shared state untouched. - First-try browser authentication: Handle one-time pairing URLs correctly, and recover consumed or expired tokens via the auth CLI. - SQLite inspection and seeding: Query or seed projection tables in state.sqlite for UI fixtures using a backup-protected helper script. - Use Case: An agent needs to verify a UI change with a human reviewer. It starts a dev server in a worktree-local .t3 directory, authenticates the controlled browser with a fresh pairing token, keeps the environment alive across turns, and only tears down when the reviewer confirms completion. ## Quick Start Use the test-t3-app skill to launch an isolated T3 dev environment and authenticate the browser so we can iterate on the web UI.

Frequently Asked Questions about test-t3-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test the T3 Code web app locally in an isolated environment?

Run vp run dev from the repository root with a worktree-local .t3 directory or a temporary base directory created via mktemp. Read the actual server port, web port, and pairing URL from the dev-runner output rather than assuming default ports.

How do I authenticate a browser with a T3 pairing URL?

Open the complete pairing URL ending in /pair#token=... exactly once as the controlled browser's first navigation, preserving the fragment verbatim. The token is single-use, so never open it in a second browser or let auto-open consume it first.

What do I do when a T3 pairing token is expired or consumed?

Create a replacement token with the auth pairing create CLI command, passing the same base directory and web URL as the running dev server plus --dev-url and --base-url. Use the new Pair URL once; the old token cannot be retried.

Can I seed SQLite data directly for T3 UI testing?

Yes, use the t3-sqlite-state.ts helper to query or exec SQL against <base-dir>/userdata/state.sqlite after stopping the dev server. Seed projection tables only for disposable UI fixtures; use app commands and APIs for behavior tests.

When should I tear down a T3 test environment?

Tear down only when the user explicitly asks or the overall testing loop is genuinely complete, not at the end of an assistant turn. Keep the dev process, base directory, and authenticated browser alive while follow-up iteration is likely.