Files
github-spec-kit/docs/install/one-time.md
Emre Değirmenci 82c078bb3a docs: clarify that release tags keep the leading v prefix (#3463)
Readers were replacing vX.Y.Z with bare versions like 0.12.11,
which fails because git tags are named v0.12.11.

Assisted-by: Cursor Grok 4.5 (supervised)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-13 10:27:18 -05:00

1.3 KiB

One-time Usage (uvx)

If you want to try Spec Kit without installing it permanently, use uvx to run it directly. This downloads the tool into a temporary environment that is discarded after the command finishes.

Note

The commands below require uv. If you see command not found: uvx, install uv first.

Run Specify CLI

# Create a new project (latest from main)
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

# Or target a specific release (replace vX.Y.Z with a tag from Releases;
# keep the leading v, e.g. v0.12.11 not 0.12.11)
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>

# Initialize in the current directory
uvx --from git+https://github.com/github/spec-kit.git specify init . --integration copilot

# Or use the --here flag
uvx --from git+https://github.com/github/spec-kit.git specify init --here --integration copilot

When to use persistent installation instead

If you plan to use Spec Kit regularly, a persistent installation is recommended:

  • Tool stays installed and available in PATH
  • No re-download on every invocation
  • Better tool management with uv tool list, uv tool upgrade, uv tool uninstall

See the main Installation Guide for persistent installation instructions.