Installation & Upgrade

Install, upgrade, repair, and uninstall the Spec Kitty CLI and project across macOS, Linux, and Windows.

  • Install Spec Kitty — macOS, Linux, and Windows Installation Guide — Step-by-step guide to install Spec Kitty on macOS, Linux, and Windows. Set up the CLI, initialize your project, and configure AI coding agents.
  • Install Spec Kitty on Linux — Install the Spec Kitty 3.2 CLI on Linux with pipx, uv, or a virtual environment and verify the command works.
  • Install Spec Kitty on macOS — Install the Spec Kitty 3.2 CLI on macOS with pipx, uv, or a virtual environment and verify the command works.
  • Install Spec Kitty on Windows — Install the Spec Kitty 3.2 CLI on Windows 10 or 11 with PowerShell, pipx, uv, or a virtual environment.
  • How to Install and Upgrade Spec Kitty — How to install and upgrade spec kitty with Spec Kitty 3.2: Spec Kitty has two distinct upgrade concepts:.
  • How to Install the Spec Kitty Claude Code Plugin — How to install Spec Kitty as a native Claude Code plugin that surfaces canonical mission commands and built-in agent profiles.
  • Non-Interactive Init Mode — How to non-interactive init mode with Spec Kitty 3.2: ✅ spec-kitty init IS fully non-interactive when --non-interactive (or the environment variable) is set.
  • Upgrade the Spec Kitty CLI — Upgrade the Spec Kitty CLI to 3.2, verify the installed binary, and know when project migrations are still required.
  • Upgrade an existing Spec Kitty project — Upgrade an existing project to the Spec Kitty 3.2 schema after installing the current CLI, with validation and recovery steps.
  • Uninstall Spec Kitty — How to uninstall spec kitty with Spec Kitty 3.2: Remove the spec-kitty CLI and, optionally, the project files it generated. This page also covers rollback.
  • Diagnose Installation Problems — How to diagnose installation problems with Spec Kitty 3.2: When Spec Kitty stops working -- skills go missing, slash commands vanish, or the runtime reports.
  • Repair Tool Surfaces After an Upgrade — How to understand the Tool vs Agent vs Tool Surface distinction in Spec Kitty 3.2 and repair missing generated surfaces with doctor tool-surfaces --fix after upgrading.
  • Fork packaging hooks — How renamed or private-index forks customize Spec Kitty upgrade checks and package identity via entry points—without overlaying core sources.
Edit this page