feat: add support for PI coding agent

[isanchez31]

Summary

• Add PI as the 19th supported AI coding agent
• PI uses .pi/skills/ directory with Markdown command format and $ARGUMENTS placeholder
• Installed via npm install -g @mariozechner/pi-coding-agent@latest

Changes

• Register pi in AGENT_CONFIG and extension system AGENT_CONFIGS
• Add PI to release packaging and GitHub release scripts
• Add PI to agent context update scripts (bash and PowerShell)
• Add PI CLI installation to devcontainer
• Update README.md and AGENTS.md documentation

Test plan

• specify init --ai pi creates .pi/skills/ with correct Markdown commands
• specify init --ai pi --script ps works with PowerShell variant
• Release packaging generates spec-kit-template-pi-sh-*.zip and spec-kit-template-pi-ps-*.zip

[Copilot]

Pull request overview

Adds PI as a newly supported AI coding agent across Spec Kit’s agent configuration, extension command registration, release packaging, devcontainer setup, and documentation.

Changes:

• Registers the pi agent in core agent config and the extension command registrar with .pi/skills markdown commands using $ARGUMENTS.
• Updates agent-context update scripts (bash + PowerShell) and release artifacts (ZIP packaging + GitHub release upload list) to include PI.
• Updates docs (README/AGENTS) and devcontainer bootstrap to install the PI CLI via npm.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/specify_cli/extensions.py	Adds pi command registration target directory/format for extension-installed commands.
src/specify_cli/__init__.py	Registers pi in AGENT_CONFIG and updates specify init --ai help text.
scripts/powershell/update-agent-context.ps1	Allows -AgentType pi and adds a PI update target.
scripts/bash/update-agent-context.sh	Adds pi as a supported agent type and update case.
README.md	Lists PI as a supported agent.
AGENTS.md	Documents PI directory/format/CLI requirements and adds PI to “Markdown format” list.
.github/workflows/scripts/create-release-packages.sh	Generates PI template ZIPs using .pi/skills and adds PI to agent list.
.github/workflows/scripts/create-github-release.sh	Uploads PI ZIPs as part of the GitHub release.
.devcontainer/post-create.sh	Installs the PI CLI via npm during devcontainer provisioning.

Comments suppressed due to low confidence (5)

scripts/bash/update-agent-context.sh:751

• print_summary()'s usage string is now more out-of-sync with what the script actually supports: update_specific_agent() includes cases for roo and amp, but the usage line does not list them. Please update the usage text to reflect all supported agent types so users don’t get incorrect guidance.

    log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|shai|q|bob|qoder|pi]"

scripts/powershell/update-agent-context.ps1:29

• The comment header lists supported agents but doesn’t include pi even though it’s now accepted in ValidateSet. Please update the header documentation so it stays consistent with the parameter validation and switch cases.

    [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','q','bob','qoder','pi')]
    [string]$AgentType

src/specify_cli/extensions.py:684

• New pi agent support in AGENT_CONFIGS isn’t covered by tests. Since tests/test_extensions.py already verifies command registration paths for other agents (e.g., Claude), consider adding a similar test that creates a .pi/skills dir and asserts commands are registered into that directory. This helps prevent regressions in agent directory mapping.

        "pi": {
            "dir": ".pi/skills",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"

.github/workflows/scripts/create-release-packages.sh:231

• The script header comment documenting the allowed AGENTS subset is now inaccurate (it omits several entries present in ALL_AGENTS, including the newly added pi). Consider deriving that comment from ALL_AGENTS or updating it so the usage docs match the actual supported values.

# Determine agent list
ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q bob qoder pi)
ALL_SCRIPTS=(sh ps)

src/specify_cli/init.py:989

• The --ai help text is hard-coded and currently omits supported agents (e.g., roo is present in AGENT_CONFIG but missing from the help string). Since validation/error output is derived from AGENT_CONFIG.keys(), consider generating this help text from AGENT_CONFIG (or at least updating the list) so the CLI help stays accurate as agents are added.

    ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, shai, q, bob, qoder, or pi"),

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mnriem]

@isanchez31 Can you pull in the latest changes from main and address the Copilot feedback?