squad-version-check

Documents squad-cli version stamping, upgrade behavior, and npm registry version probing.

2|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill squad-version-check-elbruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-version-check
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/squad-version-check
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill squad-version-check-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinators working with the @bradygaster/squad-cli need to know how versions are stamped into squad.agent.md, what squad upgrade preserves versus overwrites, and how to check the npm registry for newer versions without breaking user-owned files. ## Core Features & Use Cases - Version Stamping Internals: Explains getPackageVersion(), stampVersion(), and readInstalledVersion() in dist/cli/core/version.js, including the HTML comment and frontmatter fallback formats. - Upgrade Behavior Reference: Details what squad upgrade overwrites (templates, workflows) versus preserves (team.md, decisions.md, agent history, .squad/config.json), plus self-upgrade commands for npm, pnpm, and yarn. - Registry & Cache Probing: Provides one-liners to query npm dist-tags with a 5-second timeout and to read the OS-specific 24-hour update-check cache. - Use Case: A coordinator prompt needs to greet users with an update notice only when a newer insider build exists; this Skill supplies the exact probe command, cache schema, and TTL semantics to implement that check safely. ## Quick Start Ask the coordinator to check whether a newer version of @bradygaster/squad-cli is available on the insider channel using the npm dist-tags probe.

Frequently Asked Questions about squad-version-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the latest version of squad-cli from npm?

Run `npm view @bradygaster/squad-cli dist-tags --json` to fetch dist-tags. Apply a 5-second timeout, extract the channel tag such as dist-tags["insider"], and fall back to the normal greeting on any network or parse error.

What does squad upgrade preserve and overwrite?

squad upgrade overwrites squad.agent.md, manifest-flagged templates, and GitHub Actions workflows, then runs migrations. It preserves team.md, routing.md, decisions.md, ceremonies.md, agent history files, and .squad/config.json, which is never touched.

How does squad-cli stamp its version into squad.agent.md?

The stampVersion() function in dist/cli/core/version.js writes an HTML comment `<!-- version: X.Y.Z -->` after the frontmatter, updates the `- **Version:**` identity line, and sets the backtick-quoted greeting `Squad vX.Y.Z`.

Where is the squad-cli update-check cache stored?

The cache lives at %APPDATA%\squad-cli\update-check.json on Windows, ~/.config/squad-cli/update-check.json on Linux, and ~/Library/Application Support/squad-cli/update-check.json on macOS, with a 24-hour TTL.

What Node version does squad-cli require?

squad-cli requires Node.js 22.5.0 or later because it is an ESM-only codebase. The CLI binary is registered as `squad` via package.json bin.