spec-kit/CHANGELOG.md

Changelog

Recent changes to the Specify CLI and templates are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.1.7] - 2026-02-27

Added

• Multi-Catalog Support (#1707): Extension catalog system now supports multiple active catalogs simultaneously via a catalog stack
  • New specify extension catalogs command lists all active catalogs with name, URL, priority, and install_allowed status
  • New specify extension catalog add and specify extension catalog remove commands for project-scoped catalog management
  • Default built-in stack includes catalog.json (org-approved, installable) and catalog.community.json (discovery only) — community extensions are now surfaced in search results out of the box
  • specify extension search aggregates results across all active catalogs, annotating each result with source catalog
  • specify extension add enforces install_allowed policy — extensions from discovery-only catalogs cannot be installed directly
  • Project-level .specify/extension-catalogs.yml and user-level ~/.specify/extension-catalogs.yml config files supported, with project-level taking precedence
  • SPECKIT_CATALOG_URL environment variable still works for backward compatibility (replaces full stack with single catalog)
  • All catalog URLs require HTTPS (HTTP allowed for localhost development)
  • New CatalogEntry dataclass in extensions.py for catalog stack representation
  • Per-URL hash-based caching for non-default catalogs; legacy cache preserved for default catalog
  • Higher-priority catalogs win on merge conflicts (same extension id in multiple catalogs)
  • 13 new tests covering catalog stack resolution, merge conflicts, URL validation, and install_allowed enforcement
  • Updated RFC, Extension User Guide, and Extension API Reference documentation

[0.1.6] - 2026-02-23

Fixed

• Parameter Ordering Issues (#1641): Fixed CLI parameter parsing issue where option flags were incorrectly consumed as values for preceding options
  • Added validation to detect when --ai or --ai-commands-dir incorrectly consume following flags like --here or --ai-skills
  • Now provides clear error messages: "Invalid value for --ai: '--here'"
  • Includes helpful hints suggesting proper usage and listing available agents
  • Commands like specify init --ai-skills --ai --here now fail with actionable feedback instead of confusing "Must specify project name" errors
  • Added comprehensive test suite (5 new tests) to prevent regressions

[0.1.5] - 2026-02-21

Fixed

• AI Skills Installation Bug (#1658): Fixed --ai-skills flag not generating skill files for GitHub Copilot and other agents with non-standard command directory structures
  • Added commands_subdir field to AGENT_CONFIG to explicitly specify the subdirectory name for each agent
  • Affected agents now work correctly: copilot (.github/agents/), opencode (.opencode/command/), windsurf (.windsurf/workflows/), codex (.codex/prompts/), kilocode (.kilocode/workflows/), q (.amazonq/prompts/), and agy (.agent/workflows/)
  • The install_ai_skills() function now uses the correct path for all agents instead of assuming commands/ for everyone

[0.1.4] - 2026-02-20

Fixed

• Qoder CLI detection: Renamed AGENT_CONFIG key from "qoder" to "qodercli" to match the actual executable name, fixing specify check and specify init --ai detection failures

[0.1.3] - 2026-02-20

Added

• Generic Agent Support: Added --ai generic option for unsupported AI agents ("bring your own agent")
  • Requires --ai-commands-dir <path> to specify where the agent reads commands from
  • Generates Markdown commands with $ARGUMENTS format (compatible with most agents)
  • Example: specify init my-project --ai generic --ai-commands-dir .myagent/commands/
  • Enables users to start with Spec Kit immediately while their agent awaits formal support

[0.0.102] - 2026-02-20

• fix: include 'src/**' path in release workflow triggers (#1646)

[0.0.101] - 2026-02-19

• chore(deps): bump github/codeql-action from 3 to 4 (#1635)

[0.0.100] - 2026-02-19

• Add pytest and Python linting (ruff) to CI (#1637)
• feat: add pull request template for better contribution guidelines (#1634)

[0.0.99] - 2026-02-19

• Feat/ai skills (#1632)

[0.0.98] - 2026-02-19

• chore(deps): bump actions/stale from 9 to 10 (#1623)
• feat: add dependabot configuration for pip and GitHub Actions updates (#1622)

[0.0.97] - 2026-02-18

• Remove Maintainers section from README.md (#1618)

[0.0.96] - 2026-02-17

• fix: typo in plan-template.md (#1446)

[0.0.95] - 2026-02-12

• Feat: add a new agent: Google Anti Gravity (#1220)

[0.0.94] - 2026-02-11

• Add stale workflow for 180-day inactive issues and PRs (#1594)