How to Install and Upgrade Spec Kitty

Use this guide to install the Spec Kitty CLI and upgrade existing projects.

Release Tracks

• Recommended (main / PyPI 1.x stable): install from PyPI (spec-kitty-cli)
• Forward track (2.x): GitHub-only releases (v2.*.*) for next-generation testing

Install from PyPI

pip install spec-kitty-cli

uv tool install spec-kitty-cli

Install from GitHub

pip install git+https://github.com/Priivacy-ai/spec-kitty.git

uv tool install spec-kitty-cli --from git+https://github.com/Priivacy-ai/spec-kitty.git

One-Time Usage

pipx run spec-kitty-cli init <PROJECT_NAME>

uvx spec-kitty-cli init <PROJECT_NAME>

Upgrade Existing Projects

Run upgrades from the project root so templates and automation stay in sync.

cd /path/to/project
spec-kitty upgrade

Preview changes before applying them:

spec-kitty upgrade --dry-run

Verify Installation

spec-kitty --version

---

Command Reference

• CLI Commands - Full spec-kitty command reference
• Environment Variables - Configuration options

See Also

• Non-Interactive Init - Scripted project setup
• Legacy 0.11 migration guide - Historical migration notes

Background

• Spec-Driven Development - Why Spec Kitty exists

Getting Started

• Getting Started Tutorial - First-time walkthrough