Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/agents/squad.agent.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: Squad
name: Squad (v0.0.0-source)
description: "Your AI team. Describe what you're building, get a team of specialists that live in your repo."
version: "0.0.0-source"
---
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ npx github:bradygaster/squad
copilot
```

Select **Squad** from the `/agents` list, then:
Select **Squad (vX.Y.Z)** from the `/agents` list, then:

```
I'm starting a new project. Set up the team.
Expand Down
8 changes: 5 additions & 3 deletions docs/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## What Is Squad?

Squad gives you an AI development team through GitHub Copilot CLI. You describe what you're building. Squad proposes a team of specialists — lead, frontend, backend, tester — that live in your repo as files. Each agent runs in its own context window, reads its own knowledge, and writes back what it learned. They persist across sessions, share decisions, and get better the more you use them.
Squad gives you an AI development team through GitHub Copilot. You describe what you're building. Squad proposes a team of specialists — lead, frontend, backend, tester — that live in your repo as files. Each agent runs in its own context window, reads its own knowledge, and writes back what it learned. They persist across sessions, share decisions, and get better the more you use them.

It is not a chatbot wearing hats. Each team member is spawned as a real sub-agent with its own tools, its own memory, and its own area of expertise.

Expand All @@ -16,11 +16,13 @@ npx github:bradygaster/squad

**Requirements:**
- Node.js 22+
- GitHub Copilot CLI (the `copilot` command)
- GitHub Copilot (CLI, VS Code, Visual Studio, or Coding Agent)
- A git repository (Squad stores team state in `.ai-team/`)

This copies `squad.agent.md` into `.github/agents/` and installs templates into `.ai-team-templates/`. Your actual team (`.ai-team/`) is created at runtime when you first talk to Squad.

**Note:** When you select Squad from the agent picker, you'll see the version number in the name (e.g., "Squad (v0.3.0)"). This helps you confirm which version is installed.

---

## How Teams Form (Init Mode)
Expand Down Expand Up @@ -379,7 +381,7 @@ The coordinator uses 6.6% of its window. A 12-week veteran agent uses 4.5% — b
- **Silent success bug** — approximately 7–10% of background agent spawns complete all their file writes but return no text response. This is a platform-level issue. Squad detects it by checking the filesystem for work product and reports what it finds. Work is not lost.
- **Platform latency** — response times depend on the Copilot platform. Complex multi-agent tasks take 40–60 seconds. Simple questions are answered in 2–3 seconds.
- **Node 22+** — requires Node.js 22.0.0 or later.
- **GitHub Copilot CLI only** — no other runtimes are supported.
- **GitHub Copilot required** — Squad works across Copilot hosts (CLI, VS Code, Visual Studio, Coding Agent).
- **First session is the least capable** — agents improve as they accumulate history. Give it a few sessions before judging.

---
Expand Down
30 changes: 22 additions & 8 deletions docs/scenarios/upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,22 +57,36 @@ Example: upgrading to v0.2.0 creates `.ai-team/skills/` if it doesn't already ex

## Version Stamping

`squad.agent.md` is version-stamped on install and upgrade. You can check your installed version:
`squad.agent.md` is version-stamped on install and upgrade. The version appears in two places:

```bash
npx github:bradygaster/squad --version
```
### 1. Agent Name (Visible in UI)

The version is displayed in the agent picker across all Copilot hosts (VS Code, CLI, Visual Studio):

```yaml
name: Squad (vX.Y.Z)
```
0.2.0
```

Or look at the frontmatter in `.github/agents/squad.agent.md`:
When you select agents in Copilot, you'll see **"Squad (vX.Y.Z)"** in the dropdown — making it immediately clear which version you're running.

### 2. Version Field (For Reference)

The frontmatter also includes a standalone version field:

```yaml
version: "0.2.0"
version: "X.Y.Z"
```

### 3. CLI Check

You can also check your installed version from the command line:

```bash
npx github:bradygaster/squad --version
```

The output will show your installed version (e.g., `X.Y.Z`).

---

## Already Up to Date
Expand Down
9 changes: 7 additions & 2 deletions index.js
Original file line number Diff line number Diff line change
Expand Up @@ -468,8 +468,13 @@ const isUpgrade = cmd === 'upgrade';

// Stamp version into squad.agent.md after copying
function stampVersion(filePath) {
const content = fs.readFileSync(filePath, 'utf8');
fs.writeFileSync(filePath, content.replace('version: "0.0.0-source"', `version: "${pkg.version}"`));
let content = fs.readFileSync(filePath, 'utf8');
// Replace version field
content = content.replace(/^version:\s*"[^"]*"/m, `version: "${pkg.version}"`);
// Replace version in name field to show in agent picker UI
// Handles both "Squad" and "Squad (vX.Y.Z)" formats
content = content.replace(/^name:\s*Squad(?:\s*\([^)]*\))?$/m, `name: Squad (v${pkg.version})`);
fs.writeFileSync(filePath, content);
}

// Read version from squad.agent.md frontmatter
Expand Down