# SpecifyX
**Enhanced spec-driven development CLI with modern architecture and Jinja2 templating**
[](https://github.com/barisgit/spec-kit-improved/actions/workflows/release.yml)
[](https://badge.fury.io/py/specifyx)
<div align="center">
<p><strong><a href="https://specifyx.dev">📚 Documentation</a> • <a href="https://specifyx.dev/docs/guides/quickstart">🚀 Quick Start</a> • <a href="https://github.com/barisgit/spec-kit-improved/issues">💬 Support</a></strong></p>
</div>
---
## 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](https://github.com/github/spec-kit).
### Key Features
- **Easy Installation**: `uv tool install specifyx` or `uvx specifyx`
- **Jinja2 Templating**: Variables, conditionals, loops for complex project generation
- **Flexible Branch Naming**: Custom patterns like `feature/{name}` or `task/{id}-{name}`
- **Configuration System**: TOML-based preferences and settings
- **Interactive UI**: Menus, progress tracking, colored output
<br clear="right">
## Installation
### Using uv (recommended )
```bash
uv tool install specifyx
```
### Alternative without installation
```bash
uvx specifyx
```
### Using pipx or pip
```bash
pipx install specifyx # or: pip install specifyx
```
<br clear="left">
## Quick Start
See SpecifyX in action - initialize a new project and start building:
```bash
# Create a new project
specifyx init my-project
cd my-project
# 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
```
<div align="center">
<p><strong>🎯 <a href="https://specifyx.dev">Visit specifyx.dev for comprehensive guides and examples</a></strong></p>
</div>
## 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
<br clear="right">
## Prerequisites
- **Linux/macOS** (or WSL2 on Windows)
- **Python 3.11+**
- AI coding agent: [Claude Code](https://www.anthropic.com/claude-code), [GitHub Copilot](https://code.visualstudio.com/), or [Gemini CLI](https://github.com/google-gemini/gemini-cli)
- [uv](https://docs.astral.sh/uv/) for package management
## Development
```bash
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 .
```
<br clear="left">
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines. We welcome contributions!
## License
MIT License - see [LICENSE](./LICENSE) file.
---
<div align="center">
<p><strong>SpecifyX</strong>: Making spec-driven development accessible and powerful for modern teams.</p>
<p>🌟 <a href="https://specifyx.dev">Explore the full documentation at specifyx.dev</a> 🌟</p>
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "specifyx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "cli, development, jinja2, project-generation, spec-driven, templates, toml",
"author": null,
"author_email": "SpecifyX Contributors <blaz@paxia.co>",
"download_url": "https://files.pythonhosted.org/packages/f2/d1/2596e545c977ac8425948741aad5012c39c72bf5cca591dbc7100748031b/specifyx-0.2.6.tar.gz",
"platform": null,
"description": "# SpecifyX\n\n**Enhanced spec-driven development CLI with modern architecture and Jinja2 templating**\n\n[](https://github.com/barisgit/spec-kit-improved/actions/workflows/release.yml)\n[](https://badge.fury.io/py/specifyx)\n\n<div align=\"center\">\n <p><strong><a href=\"https://specifyx.dev\">\ud83d\udcda Documentation</a> \u2022 <a href=\"https://specifyx.dev/docs/guides/quickstart\">\ud83d\ude80 Quick Start</a> \u2022 <a href=\"https://github.com/barisgit/spec-kit-improved/issues\">\ud83d\udcac Support</a></strong></p>\n</div>\n\n---\n\n## What is SpecifyX?\n\n\n\nSpecifyX 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](https://github.com/github/spec-kit).\n\n### Key Features\n\n- **Easy Installation**: `uv tool install specifyx` or `uvx specifyx` \n- **Jinja2 Templating**: Variables, conditionals, loops for complex project generation\n- **Flexible Branch Naming**: Custom patterns like `feature/{name}` or `task/{id}-{name}`\n- **Configuration System**: TOML-based preferences and settings\n- **Interactive UI**: Menus, progress tracking, colored output\n\n<br clear=\"right\">\n\n## Installation\n\n### Using uv (recommended )\n```bash\nuv tool install specifyx\n```\n\n### Alternative without installation\n```bash\nuvx specifyx\n```\n\n### Using pipx or pip\n```bash\npipx install specifyx # or: pip install specifyx\n```\n\n<br clear=\"left\">\n\n## Quick Start\n\nSee SpecifyX in action - initialize a new project and start building:\n\n```bash\n# Create a new project\nspecifyx init my-project\ncd my-project\n\n# Check system requirements \nspecifyx check\n\n# Traditional workflow (with feature branches)\nspecifyx run create-feature \"User authentication\"\nspecifyx run setup-plan setup\nspecifyx run generate-tasks\n\n# No-branch workflow (single branch development)\nspecifyx run create-feature \"User login\" --no-branch\nspecifyx run setup-plan setup --spec-id 001\nspecifyx run generate-tasks --spec-id 001\n```\n\n<div align=\"center\">\n <p><strong>\ud83c\udfaf <a href=\"https://specifyx.dev\">Visit specifyx.dev for comprehensive guides and examples</a></strong></p>\n</div>\n\n## What is Spec-Driven Development?\n\nSpec-Driven Development makes **specifications executable** - directly generating working implementations rather than just guiding them.\n\n### Core Philosophy\n- **Intent-driven** development where specs define \"_what_\" before \"_how_\"\n- **Multi-step refinement** rather than one-shot code generation\n- **AI-enhanced** specification interpretation and implementation\n\n<br clear=\"right\">\n\n## Prerequisites\n\n- **Linux/macOS** (or WSL2 on Windows)\n- **Python 3.11+**\n- AI coding agent: [Claude Code](https://www.anthropic.com/claude-code), [GitHub Copilot](https://code.visualstudio.com/), or [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- [uv](https://docs.astral.sh/uv/) for package management\n\n## Development\n\n```bash\ngit clone https://github.com/barisgit/spec-kit-improved\ncd spec-kit-improved\nuv sync --extra dev\n\n# Run tests\npytest\n\n# Code quality\nruff check . && ruff format . && pyrefly check .\n```\n\n<br clear=\"left\">\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines. We welcome contributions!\n\n## License\n\nMIT License - see [LICENSE](./LICENSE) file.\n\n---\n\n<div align=\"center\">\n <p><strong>SpecifyX</strong>: Making spec-driven development accessible and powerful for modern teams.</p>\n <p>\ud83c\udf1f <a href=\"https://specifyx.dev\">Explore the full documentation at specifyx.dev</a> \ud83c\udf1f</p>\n</div>",
"bugtrack_url": null,
"license": "MIT",
"summary": "Enhanced spec-driven development CLI with modern architecture and Jinja2 templating",
"version": "0.2.6",
"project_urls": null,
"split_keywords": [
"cli",
" development",
" jinja2",
" project-generation",
" spec-driven",
" templates",
" toml"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "914b97a95f35aa5e86b642fcaed4f213ce9522824d8c36b6bb4c5fdb09660809",
"md5": "37a1440a2a9ee624f9f7d433a4f3b7ed",
"sha256": "b95e65d77b9e3db1ccad181270c901bede476ae2e01c304fc35deb179cb8b69d"
},
"downloads": -1,
"filename": "specifyx-0.2.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37a1440a2a9ee624f9f7d433a4f3b7ed",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 227989,
"upload_time": "2025-09-12T10:37:52",
"upload_time_iso_8601": "2025-09-12T10:37:52.508213Z",
"url": "https://files.pythonhosted.org/packages/91/4b/97a95f35aa5e86b642fcaed4f213ce9522824d8c36b6bb4c5fdb09660809/specifyx-0.2.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f2d12596e545c977ac8425948741aad5012c39c72bf5cca591dbc7100748031b",
"md5": "e4ccef7a229973fc98bd07acd97c4e9f",
"sha256": "bea5b1d2d9a266dcd831edbbf2ab2f20d2627b1a59f0afead64829c47dd3fea2"
},
"downloads": -1,
"filename": "specifyx-0.2.6.tar.gz",
"has_sig": false,
"md5_digest": "e4ccef7a229973fc98bd07acd97c4e9f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 171984,
"upload_time": "2025-09-12T10:37:53",
"upload_time_iso_8601": "2025-09-12T10:37:53.769278Z",
"url": "https://files.pythonhosted.org/packages/f2/d1/2596e545c977ac8425948741aad5012c39c72bf5cca591dbc7100748031b/specifyx-0.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-12 10:37:53",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "specifyx"
}
JSON