Spec Kitty is an open-source command-line interface (CLI) tool that facilitates spec-driven development for AI coding agents. It is designed to transform product intent into a structured, repeatable agent workflow. The tool stores critical context, including requirements, decisions, and acceptance criteria, directly within the repository under a `kitty-specs/` directory. It supports various AI coding models such as Claude, Cursor, Gemini, and Codex.
Key features of Spec Kitty include the creation of work packages with lifecycle lanes (e.g., planned, in progress, for review, approved, done), which help in splitting implementation work and providing clear boundaries for multiple agents or developers. To prevent 'branch chaos,' it utilizes isolated Git worktrees under `.worktrees/`. Developers can monitor progress through an optional local Kanban dashboard. The tool also integrates with common AI coding tools via slash commands or skills and generates retrospectives for every completed mission to facilitate learning and tuning.
Installation is recommended via `pipx` to ensure an isolated virtual environment. Users can initialize a project, specify an AI agent (e.g., `claude`, `gemini`, `copilot`), and then run the core workflow to guide the agent through the mission. After completion, a mission review generates a `retrospective.yaml` for cross-mission insights.