v0.9.0

What's Changed

• release: v0.9.0 — the loop release by @kokevidaurre in #1033

Full Changelog: v0.8.3...v0.9.0

v0.8.3

What's Changed

• release: v0.8.3 — the first-run journey release by @agents-squads[bot] in #1005

Full Changelog: v0.8.2...v0.8.3

v0.8.2

What's Changed

• release: v0.8.2 — trustworthy execution follow-through by @agents-squads[bot] in #927

Full Changelog: v0.8.1...v0.8.2

v0.8.1

What's Changed

• release: v0.8.1 — run containment + introspection by @agents-squads[bot] in #854

Full Changelog: v0.8.0...v0.8.1

v0.8.0

What's Changed

• release: v0.8.0 — trustworthy execution by @agents-squads[bot] in #831

Full Changelog: v0.3.3...v0.8.0

v0.3.3 — runtime reliability + cost observability

What's Changed

• release: v0.3.3 — runtime reliability by @agents-squads[bot] in #811

Full Changelog: v0.3.2...v0.3.3

v0.3.2 — agent runtime, founder-context, safety/governance, autonomy

What's Changed

• fix(ci): --force on npm self-upgrade — unblock v0.3.1 publish by @kokevidaurre in #760
• release: v0.3.2 — agent runtime, founder-context, safety/governance, autonomy by @agents-squads[bot] in #799
• release: drop EOL Node 18 → unblock v0.3.2 publish (cherry-pick #802) by @agents-squads[bot] in #804

Full Changelog: v0.3.1...v0.3.2

v0.3.1 — Conversation Protocol

What's in this release

v0.3.1 ships the conversation protocol — the foundation for how squads work as teams. Agents no longer run in isolation; they share context, brief each other, challenge outputs, and converge on a result before stopping.

This is the first stable release on npm @latest, promoted from v0.3.0-rc.1 after burn-in on @next.

v0.3.0 was skipped — that version slot is reserved by a historical pre-release; npm enforces version immutability.

---

Conversation Protocol

squads run <squad> now drives a structured multi-agent conversation:

1. Lead reads goals, priorities, and recent state — then briefs workers
2. Workers execute tasks, use tools, and report progress mid-conversation
3. Lead reviews outputs and requests corrections if needed
4. Verifier confirms the work meets exit criteria

Agents share a live transcript and can hand off context to each other. The conversation continues until it converges or reaches a configured limit.

Org Cycle

squads run with no target now runs the full organization:

• Squads execute in waves based on dependencies
• Smart-skip: squads with unchanged goals and priorities are skipped automatically
• Interrupted runs resume from where they left off — completed squads are not re-run
• --force re-runs everything regardless of state

Role-Based Timeouts

Workers, leads, and verifiers each have appropriate time limits per role — replacing the old hardcoded ceiling that was simultaneously too tight for leads and too loose for scanners.

New Commands

Command	What it does
squads review	Trigger a review pass from the squad lead
squads credentials	Add, rotate, and validate API keys
squads goals	Read and update squad goals
squads log	Browse agent conversation history

Existing commands (init, status, run) also received refinements in this release.

Project Configuration

.squads/config.yml lets you set per-project defaults without environment variables. Resolution order: env var → config file → built-in defaults.

Safety Hooks

Agents now support PreToolUse hooks — shell commands that run before any agent action executes. Return a non-zero exit code to block the action. Use this for approval gates, audit logs, or environment guards.

Better squads init

The init command now scaffolds starter agents with working definitions, an example squad, and step-by-step guidance for what to do next. A growth squad template is also included in the seed templates.

---

Install

```bash
npm install -g squads-cli
squads --version # 0.3.1
```

Pre-release channel: npm install -g squads-cli@next
Changelog: https://github.com/agents-squads/squads-cli/blob/main/CHANGELOG.md

v0.3.0-rc.1 — pre-release burn-in

Pre-release candidate published to npm @next for burn-in. Promoted to @latest as v0.3.1.

```bash
npm install -g squads-cli@next
```

See v0.3.1 release notes for the full changelog.

v0.2.2 — Observability & IDP

What's in this release

v0.2.2 adds two major layers: observability (what did your agents do, and what did it cost?) and an internal developer platform (how do you manage them as a proper system?).

---

Observability

Track every agent execution — cost, tokens, duration — without manual instrumentation.

squads obs history
View execution history for any squad. Shows token usage, cost, model, and duration per run.

squads obs cost
Spend summary broken down by squad and model. Identify which squads are expensive and why.

squads obs sync
Push local execution logs to Postgres for long-term storage and cross-device access.

Executions are logged to .agents/observability/executions.jsonl — a structured append-only log that other tools can consume directly.

---

Internal Developer Platform (IDP)

Manage your agent system as a first-class software platform.

squads catalog
Service catalog for your agents and squads. Browse what exists, inspect definitions, and validate structure against the schema.

squads release
Pre-release scorecard checks. Before promoting a squad, verify it meets your defined criteria (has goals, a lead, defined roles, etc.).

Structured frontmatter
Agents now support spec.type, spec.squad, and spec.role in their YAML frontmatter. The catalog and release commands use these fields for validation.

---

Architecture Tiers

squads tier shows which tier your current setup is running at:

Tier	What it means
Tier 1	Local only — no external services required
Tier 2	Local services running (Postgres, Bridge)
Tier 3	Cloud execution

squads services starts, stops, and checks the status of local services.

---

Org Cycle Improvements

• Smart-skip: squads re-run only when their goals or priorities changed since the last execution
• --force flag to override and re-run everything
• Improved quota handling: waits and retries instead of failing on rate limits

---

Install

```bash
npm install -g squads-cli
```

Full changelog: v0.2.1...v0.2.2