💫 Toolkit to help you get started with SDD or any other process!
feat: support 'specify init .' for current directory initialization
Bruno Borges68eba52a40a0
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 92cb0b8b3..d9485cb4c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,12 @@ All notable changes to the Specify CLI will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).+## [LATEST_VERSION] - RELEASE_DATE++### Added++- Support for using `.` as a shorthand for current directory in `specify init .` command, equivalent to `--here` flag but more intuitive for users+## [0.0.17] - 2025-09-22### Addeddiff --git a/README.md b/README.mdindex 226da68f1..f62e6d7de 100644--- a/README.md+++ b/README.md@@ -150,13 +150,13 @@ The `specify` command supports the following options:| Argument/Option | Type | Description ||------------------------|----------|------------------------------------------------------------------------------|-| `<project-name>` | Argument | Name for your new project directory (optional if using `--here`) |+| `<project-name>` | Argument | Name for your new project directory (optional if using `--here`, or use `.` for current directory) || `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, or `roo` || `--script` | Option | Script variant to use: `sh` (bash/zsh) or `ps` (PowerShell) || `--ignore-agent-tools` | Flag | Skip checks for AI agent tools like Claude Code || `--no-git` | Flag | Skip git repository initialization || `--here` | Flag | Initialize project in the current directory instead of creating a new one |-| `--force` | Flag | Force merge/overwrite when using `--here` in a non-empty directory (skip confirmation) |+| `--force` | Flag | Force merge/overwrite when initializing in current directory (skip confirmation) || `--skip-tls` | Flag | Skip SSL/TLS verification (not recommended) || `--debug` | Flag | Enable detailed debug output for troubleshooting || `--github-token` | Option | GitHub token for API requests (or set GH_TOKEN/GITHUB_TOKEN env variable) |@@ -180,9 +180,13 @@ specify init my-project --ai windsurfspecify init my-project --ai copilot --script ps# Initialize in current directory+specify init . --ai copilot+# or use the --here flagspecify init --here --ai copilot# Force merge into current (non-empty) directory without confirmation+specify init . --force --ai copilot+# orspecify init --here --force --ai copilot# Skip git initialization@@ -292,8 +296,12 @@ specify init <project_name>Or initialize in the current directory:```bash+specify init .+# or use the --here flagspecify init --here# Skip confirmation when the directory already has files+specify init . --force+# orspecify init --here --force```@@ -311,9 +319,14 @@ specify init <project_name> --ai opencodespecify init <project_name> --ai codexspecify init <project_name> --ai windsurf# Or in current directory:+specify init . --ai claude+specify init . --ai codex+# or use --here flagspecify init --here --ai claudespecify init --here --ai codex# Force merge into a non-empty current directory+specify init . --force --ai claude+# orspecify init --here --force --ai claude```diff --git a/docs/installation.md b/docs/installation.mdindex 7cf9a6ae9..b30b09482 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -21,6 +21,8 @@ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAMEOr initialize in the current directory:```bash+uvx --from git+https://github.com/github/spec-kit.git specify init .+# or use the --here flaguvx --from git+https://github.com/github/spec-kit.git specify init --here```diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.pyindex 83d2fdf87..36b7418cc 100644--- a/src/specify_cli/__init__.py+++ b/src/specify_cli/__init__.py@@ -14,11 +14,13 @@ Specify CLI - Setup tool for Specify projectsUsage:uvx specify-cli.py init <project-name>+ uvx specify-cli.py init .uvx specify-cli.py init --hereOr install globally:uv tool install --from specify-cli.py specify-clispecify init <project-name>+ specify init .specify init --here"""@@ -747,7 +749,7 @@ def ensure_executable_scripts(project_path: Path, tracker: StepTracker | None =@app.command()def init(- project_name: str = typer.Argument(None, help="Name for your new project directory (optional if using --here)"),+ project_name: str = typer.Argument(None, help="Name for your new project directory (optional if using --here, or use '.' for current directory)"),ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor, qwen, opencode, codex, windsurf, kilocode, or auggie"),script_type: str = typer.Option(None, "--script", help="Script type to use: sh or ps"),ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for AI agent tools like Claude Code"),@@ -781,7 +783,9 @@ def init(specify init my-project --ai windsurfspecify init my-project --ai auggiespecify init --ignore-agent-tools my-project- specify init --here --ai claude+ specify init . --ai claude # Initialize in current directory+ specify init . # Initialize in current directory (interactive AI selection)+ specify init --here --ai claude # Alternative syntax for current directoryspecify init --here --ai codexspecify init --herespecify init --here --force # Skip confirmation when current directory not empty@@ -789,13 +793,18 @@ def init(# Show banner firstshow_banner()+ # Handle '.' as shorthand for current directory (equivalent to --here)+ if project_name == ".":+ here = True+ project_name = None # Clear it so validation logic works correctly+# Validate argumentsif here and project_name:console.print("[red]Error:[/red] Cannot specify both project name and --here flag")raise typer.Exit(1)if not here and not project_name:- console.print("[red]Error:[/red] Must specify either a project name or use --here flag")+ console.print("[red]Error:[/red] Must specify either a project name, use '.' for current directory, or use --here flag")raise typer.Exit(1)# Determine project directory