SpecifyX

Enhanced spec-driven development CLI with modern architecture and Jinja2 templating

What is SpecifyX?

SpecifyX is a modern Python CLI tool for spec-driven development that helps teams focus on product scenarios rather than writing boilerplate code. Enhanced fork of GitHub's spec-kit.

Key Features

• Easy Installation: uv tool install specifyx or uvx specifyx
• AI Assistant Management: Add and configure multiple AI assistants (Claude, Copilot, Cursor, Gemini)
• Jinja2 Templating: Variables, conditionals, loops for complex project generation
• Flexible Branch Naming: Custom patterns like feature/{name}, task/{id}-{name}, or no-branch workflow
• Configuration System: TOML-based preferences and settings
• Interactive UI: Menus, progress tracking, colored output

Installation

Using uv (recommended )

uv tool install specifyx

Alternative without installation

uvx specifyx

Using pipx or pip

pipx install specifyx  # or: pip install specifyx

Quick Start

Get started with SpecifyX in 3 simple steps:

# 1. Install SpecifyX
uv tool install specifyx

# 2. Create a new project
specifyx init my-awesome-project
cd my-awesome-project

# 3. Start building with AI
# Use /specify command with your AI assistant to create specifications

📖 Complete Quick Start Guide →

For detailed instructions, examples, and AI assistant integration, see our comprehensive guide.

What is Spec-Driven Development?

Spec-Driven Development makes specifications executable - directly generating working implementations rather than just guiding them.

Core Philosophy

• Intent-driven development where specs define "what" before "how"
• Multi-step refinement rather than one-shot code generation
• AI-enhanced specification interpretation and implementation

Prerequisites

• Linux/macOS (or WSL2 on Windows)
• Python 3.11+
• AI Assistant: Choose one or more:
  • Claude Code - Anthropic's AI coding assistant
  • GitHub Copilot - GitHub's AI assistant
  • Cursor - AI-powered code editor
  • Gemini CLI - Google's AI assistant
• uv for package management

AI Assistant Setup

SpecifyX supports multiple AI assistants with dedicated configurations:

# Add AI assistants to your project
specifyx add-ai claude              # Add Claude Code
specifyx add-ai copilot,cursor      # Add multiple assistants
specifyx add-ai --interactive       # Interactive selection

# Update templates when assistants change
specifyx refresh-templates

Development

git clone https://github.com/barisgit/spec-kit-improved
cd spec-kit-improved
uv sync --extra dev

# Run tests
pytest

# Code quality
ruff check . && ruff format . && pyrefly check .

Contributing

See CONTRIBUTING.md for guidelines. We welcome contributions!

License

MIT License - see LICENSE file.