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
--forceflag 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