specifyx 0.3.0

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

SpecifyX

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

Documentation • Quick Start • Support

---

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

See SpecifyX in action - initialize a new project and start building:

# Create a new project with AI assistant
specifyx init my-project --ai claude
cd my-project

# Or add AI assistants to existing project
specifyx add-ai claude,copilot

# Check system requirements
specifyx check

# Traditional workflow (with feature branches)
specifyx run create-feature "User authentication"
specifyx run setup-plan setup
specifyx run generate-tasks

# No-branch workflow (single branch development)
specifyx run create-feature "User login" --no-branch
specifyx run setup-plan setup --spec-id 001
specifyx run generate-tasks --spec-id 001

Visit specifyx.dev for comprehensive guides and examples

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.

---

SpecifyX: Making spec-driven development accessible and powerful for modern teams.

🌟 Explore the full documentation at specifyx.dev 🌟