GitDocs
CSS framework package and behavior drift

Tailwind CSS v4 CLI @tailwindcss/cli npx tailwindcss command not found official docs

A current Tailwind CSS 4 task fails with: Tailwind v4 `npx tailwindcss` command not found; use `@tailwindcss/cli`.

search-observedTailwind CSS 4CSS toolingCSS framework package and behavior driftgitdocs_candidate100

Agent Quick Fix

The local workspace gives the symptom and stale integration shape, but the correct repair depends on current official product behavior or recent release notes.

Product: Tailwind CSS 4
Current-contract area: Tailwind v4 `npx tailwindcss` command not found; use `@tailwindcss/cli`
Likely root cause: A current Tailwind CSS 4 task fails with: Tailwind v4 `npx tailwindcss` command not found; use `@tailwindcss/cli`. The local stale integration is plausible but may not reflect the current external contract.
Repair direction: Verifier accepts a repair record only if it states the current contract and an actionable fix using source-backed product terms.

Validation Status

Codex searched organically, but the no-web counterfactual also passed under this fixture. Treat this as search-observed query evidence, not proof that search was necessary.

Symptom

A current Tailwind CSS 4 task fails with: Tailwind v4 `npx tailwindcss` command not found; use `@tailwindcss/cli`. The local stale integration is plausible but may not reflect the current external contract.

Why This Happens

The local workspace gives the symptom and stale integration shape, but the correct repair depends on current official product behavior or recent release notes.

Verification

Verifier accepts a repair record only if it states the current contract and an actionable fix using source-backed product terms.

Common Wrong Fixes

  • Changing local code without checking the current external contract.
  • Retrying the same install, build, or API call with no version/source change.
  • Applying a broad unsafe bypass when a narrow compatibility fix is available.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

Tailwind CSS v4 CLI @tailwindcss/cli npx tailwindcss command not found official docs
https://tailwindcss.com/docs/installation/tailwind-cli
'@tailwindcss/cli' in https://tailwindcss.com/blog/tailwindcss-v4
https://raw.githubusercontent.com/tailwindlabs/tailwindcss/main/packages/tailwindcss/package.json

Source Trail

GitHub source file/reference: