From 73312ca819cd2b2d56c25a76b6d26a7affee4710 Mon Sep 17 00:00:00 2001 From: jawwad-ali Date: Wed, 22 Jul 2026 15:58:55 +0500 Subject: [PATCH 1/2] docs(installation): document the 'py' (Python) script type MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The installation guide's "Specify Script Type" section only showed `--script sh` and `--script ps`, and the installed-variant list only mentioned `.specify/scripts/bash/` and `.specify/scripts/powershell/`. The CLI has a third script type, `py`: `SCRIPT_TYPE_CHOICES` in `_agent_config.py` includes `"py": "Python"`, and `shared_infra.py` installs a `python/` variant directory (plus the platform shell fallback) when `--script py` is chosen. Add the missing `--script py` force example and a `.specify/scripts/python/` bullet so the docs match the code. Docs-only. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/installation.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/installation.md b/docs/installation.md index 9fb2bf519f..d9350b08ca 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -92,6 +92,7 @@ Force a specific script type: ```bash specify init --script sh specify init --script ps +specify init --script py ``` ### Ignore Agent Tools Check @@ -131,6 +132,7 @@ Scripts are installed into a variant subdirectory matching the chosen script typ - `.specify/scripts/bash/` — contains `.sh` scripts (default on Linux/macOS) - `.specify/scripts/powershell/` — contains `.ps1` scripts (default on Windows) +- `.specify/scripts/python/` — contains `.py` scripts (chosen with `--script py`; also installs the platform shell fallback) ## Troubleshooting From 7e6ca7cc484a4eb63596d14c1ed537ac44ca654c Mon Sep 17 00:00:00 2001 From: jawwad-ali Date: Wed, 22 Jul 2026 16:10:09 +0500 Subject: [PATCH 2/2] docs(installation): frame Python as a first-class third script type MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Address review feedback: update the section heading and intro so Python is presented as a first-class script type alongside Shell and PowerShell, matching the added --script py example and python/ variant directory. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/installation.md b/docs/installation.md index d9350b08ca..4fa2795647 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -77,9 +77,9 @@ specify init --integration pi specify init --integration omp ``` -### Specify Script Type (Shell vs PowerShell) +### Specify Script Type (Shell, PowerShell, or Python) -All automation scripts now have both Bash (`.sh`) and PowerShell (`.ps1`) variants. +Automation scripts are available as Bash (`.sh`), PowerShell (`.ps1`), and Python (`.py`) variants. Auto behavior: