Display Squad version in agent name across Copilot hosts

[Copilot]

Squad version was invisible in agent picker UIs. Users couldn't determine installed version without checking files manually.

Changes

Agent template (.github/agents/squad.agent.md)

• Changed name: Squad → name: Squad (v0.0.0-source) in frontmatter
• Version placeholder gets stamped during install/upgrade

Version stamping (index.js)

• Enhanced stampVersion() to replace version in both version: and name: fields
• Uses regex pattern /^name:\s*Squad(?:\s*\([^)]*\))?$/m to handle:
  • Fresh installs from source template
  • Upgrades from any previous version
  • Manual edits that removed version

Documentation

• Added version display details to docs/scenarios/upgrading.md
• Updated docs/guide.md to clarify multi-host Copilot support (not CLI-only)
• Updated README.md example

Result

# Before
name: Squad

# After
name: Squad (v0.3.0)

Agent picker now shows Squad (v0.3.0) across all Copilot hosts (VS Code, CLI, Visual Studio, Coding Agent). The name field is the only frontmatter property consistently displayed in picker UIs.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Show squad version number in agent label across Copilot hosts</issue_title>
<issue_description>When Squad agents spawn, the host UI shows an agent label (e.g. in Copilot CLI it shows the agent type/description). It would be useful to display the Squad version number somewhere in that label or output so users know which version of Squad is running.

Why:

• Helps with debugging and support — users can immediately see which version they're on
• Makes it clear when an update is available or when behavior changed between versions
• Useful across all hosts: Copilot CLI, VS Code, Visual Studio, coding agent

Acceptance criteria:

• Investigate what's controllable in the agent label/description across Copilot hosts
• If possible, include the version from package.json in the spawn output or agent label
• If the host doesn't support custom labels, find the next best surface (e.g. first line of agent output, status message)
• Document which hosts support this and which don't

Notes:

• This is a UX/platform investigation — the answer may be 'not possible on host X' and that's fine
• Version is already in package.json (</issue_description>

<agent_instructions>Please figure out what is possible in terms of customizing the agent's name in the copilot CLI, VS Code, and Visual Studio experiences. Ideally, the agent name "squad" is consistent but, we could have a "description" property that gets shown in the tool we could capitalize on. If it is possible, work through the plan for implementing it so users can always see what version they're on in all the experiences. </agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Show squad version number in agent label across Copilot hosts #18

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.