Skip to content

Installation Guide (Fork)

Prerequisites

  • Linux/macOS (or Windows; PowerShell scripts now supported without WSL)
  • AI coding agent: see full list in agents.md
  • uv for package management
  • Python 3.11+
  • Git

Installation

Initialize a New Project (Fork)

The easiest way to get started is to initialize a new project:

uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <PROJECT_NAME>

```text

Or initialize in the current directory:

```bash
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init .
# or use the --here flag
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init --here

Specify AI Agent

You can proactively specify your AI agent during initialization:

uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai claude
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai gemini
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai copilot
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai codebuddy

```text

### Specify Script Type (Shell vs PowerShell)

All automation scripts now have both Bash (`.sh`) and PowerShell (`.ps1`) variants.

Auto behavior:

- Windows default: `ps`
- Other OS default: `sh`
- Interactive mode: you'll be prompted unless you pass `--script`

Force a specific script type:

```bash
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --script sh
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --script ps

Use a Template Override (Advanced)

If you need to override templates explicitly:

export SPECIFY_TEMPLATE_REPO="your-org/spec-kit"
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai codex

# or pass explicitly

uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --template-repo your-org/spec-kit --ai codex

```text

### Ignore Agent Tools Check

If you prefer to get the templates without checking for the right tools:

```bash
uvx --from git+https://github.com/nsalvacao/spec-kit.git specify init <project_name> --ai claude --ignore-agent-tools

Verification

After initialization, you should see the following commands available in your AI agent:

  • /speckit.brainstorm - Strategic pre-phase (feeds IDEATE)
  • /speckit.execution-plan - Strategic execution planning artifact
  • /speckit.strategic-review - Strategic readiness scoring before launch
  • /speckit.ideate - Phase 0 ideation
  • /speckit.select - Phase 0 selection
  • /speckit.structure - Phase 0 structure
  • /speckit.validate - Phase 0 validation
  • /speckit.specify - Create specifications
  • /speckit.plan - Generate implementation plans
  • /speckit.tasks - Break down into actionable tasks

The .specify/scripts directory will contain both .sh and .ps1 scripts.

Troubleshooting

Git Credential Manager on Linux

If you're having issues with Git authentication on Linux, you can install Git Credential Manager:

```bash

!/usr/bin/env bash

set -e echo "Downloading Git Credential Manager v2.6.1..." wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb echo "Installing Git Credential Manager..." sudo dpkg -i gcm-linux_amd64.2.6.1.deb echo "Configuring Git to use GCM..." git config --global credential.helper manager echo "Cleaning up..." rm gcm-linux_amd64.2.6.1.deb

```text