← ClaudeAtlas

test-notcodex-applisted

Launch and test the Not Codex web app in isolated development environments, including first-try browser authentication with one-time pairing URLs, pairing-token recovery, worktree-safe state directories, dev server lifecycle, and direct SQLite inspection or fixture seeding. Use when an agent needs to run Not Codex locally, test UI behavior in a browser, recover from an expired or consumed pairing token, isolate dev state, or prepare test data in state.sqlite.
MaTriXy/not-codex · ★ 0 · Testing & QA · score 70
Install: claude install-skill MaTriXy/not-codex
# Test Not Codex App ## Start an isolated web environment 1. Run commands from the repository root. 2. Choose a base directory that belongs only to the current worktree or test: - Use the repository's ignored `.notcodex` directory for reusable worktree-local state. - Use `mktemp -d /tmp/notcodex-test.XXXXXX` for disposable state and retain the printed absolute path. 3. Start the full web stack with `vp run dev --home-dir <base-dir>`. 4. Keep the terminal session alive and read the selected server port, web port, base directory, and pairing URL from its output. Treat a base directory as disposable only when it was created or deliberately selected for the current test. Never delete or directly seed the shared `~/.notcodex` directory. Prefer starting with a new temporary base directory over clearing state of uncertain ownership. The dev runner disables browser auto-open by default. Do not pass `--browser` during automated testing: an automatically opened page can consume the one-time bootstrap token before the controlled browser uses it. ## Authenticate the browser on the first navigation 1. Wait for the server log that says authentication is required and includes a URL ending in `/pair#token=...`. 2. Use the controlled in-app browser or browser-automation surface available to the agent. Do not use a system-browser launch command during automated testing. 3. Open that complete URL exactly once as the controlled browser's first navigation. Preserve the fragment and to