v0.2.2 — IDP, observability, tiered architecture, org cycle

What's new

Major release adding the IDP (Internal Developer Platform) layer, observability commands, tiered architecture, and org cycle improvements.

IDP (Internal Developer Platform)

• squads catalog — service catalog: browse, inspect, and validate services
• squads release — release pre-checks against IDP scorecard
• Structured agent frontmatter with spec.type, spec.squad, spec.role

Observability

• squads obs history — execution history with tokens and cost
• squads obs cost — spend summary by squad and model
• squads obs sync — sync JSONL execution log to Postgres
• JSONL-based observability log at .agents/observability/executions.jsonl

Tiered Architecture

• squads tier — show current architecture tier (Tier 1/2/3)
• squads services — manage local services (Postgres, Bridge)

Org Cycle

• Smart skip: re-run squads only when goals/priorities changed
• Wait on quota + skip completed squads on resume
• --force flag to re-run all squads

Cognition

• squads cognition — business cognition engine commands

Quality

• 1779 tests passing across 87 test files
• 13/13 Docker fresh-user tests pass

Install / upgrade

npm install -g squads-cli

Full Changelog: v0.2.1...v0.2.2

v0.2.1 — First-run experience reset

What's new

Complete reset of the first-run experience. A new user can now:

npm install -g squads-cli
mkdir my-project && cd my-project && git init
squads init --yes
squads run research/lead

...and get useful AI agent output in under 5 minutes.

Changes

• 4 core squads for every user: research, company, intelligence, product
• Default business brief: tracks big AI players (Anthropic, OpenAI, Google, Amazon, Meta, xAI)
• Auto-commits scaffolding so agents can use git worktrees immediately
• gh CLI is optional — warning instead of hard error
• squads run is the unified entry point (replaces squads auto start)
• Context cascade: SYSTEM.md → SQUAD.md → priorities → directives → state
• Phase-ordered execution with depends_on in SQUAD.md frontmatter
• Role-based context injection (scanner/worker/lead/coo profiles)
• 1732 tests passing across 87 test files
• Platform-agnostic install hints (no more brew install gh on Linux)

Install / upgrade

npm install -g squads-cli

Full Changelog: v0.6.2...v0.2.1

v0.6.2

What's Changed

• fix: extract hardcoded values to constants, read cooldown from frontmatter by @kokevidaurre in #347

Full Changelog: v0.6.1...v0.6.2

v0.6.1

What's Changed

• docs: Comprehensive README with all commands and examples by @kokevidaurre in #1
• Release v0.6.0 by @kokevidaurre in #336
• Release v0.6.1 by @kokevidaurre in #345

Full Changelog: https://github.com/agents-squads/squads-cli/commits/v0.6.1

v0.6.0

squads-cli v0.6.0

Security

• fix(security): escape HTML in OAuth callback responses (#323)
• fix(security): prevent shell injection in agent spawn (#324)
• fix(security): restrict auth file permissions to owner-only (#325)

Added

• Git worktree isolation for concurrent agent execution
• Multi-provider model routing (Claude, Gemini, GPT, Ollama)
• Memory injection from daily briefing + cross-squad learnings
• Event emission on agent completion
• Ralph verification loop (verify → re-run)
• squads eval readiness scorer
• squads deploy command
• Dashboard ROI metrics, cost projections, baseline command
• Squad-scoped skills and MCP servers
• Interactive init, session filtering
• Light mode terminal palette
• Privacy indicators in CLI output

Changed

• Removed pg, ioredis, supabase dependencies (lighter install)
• Deprecated -e flag, added native Claude execution pattern

Fixed

• Worktree isolation replaces git checkout -b (no branch collisions)
• Unset CLAUDECODE env var to allow nested Claude Code execution
• Memory format updated to ## YYYY-MM-DD: for synthesizer compatibility
• 15+ additional bug fixes (see CHANGELOG.md)

Tests

• 14 new test suites covering core commands, database ops, dashboard renderers, LLM CLIs, and more

Installation

npm install -g squads-cli@0.6.0

Full Changelog

https://github.com/agents-squads/squads-cli/blob/main/CHANGELOG.md

v0.5.1 - Model Routing & Security Hardening

Highlights

Features

• Model routing: --model flag for task-difficulty routing (#182)
• Sprint goals: Display sprint goals in status view
• Time-windowed stats: Show execution statistics with time windows in trigger command
• Lead orchestration: Add lead-orchestrated squad execution
• Security: Pre-commit hook to block PII leakage

Performance

• 385% faster help command: Lazy-load ioredis to eliminate startup regression (#190)

Fixes

• Cross-platform path handling in cron/autonomous commands (#207)
• Scheduler offline error handling in trigger list (#196)
• Support squad/agent slash syntax in run command
• Use branch/PR workflow instead of direct main push (#180)
• Replace tmux with nohup for background execution (#181)
• Use absolute paths in Claude Code hooks (#189)

Security

• Remove hardcoded database credentials from db.ts (#195)

UX Improvements

• Clarify dashboard budget display for different plans (#198)
• Show help after missing required arguments (#197)
• Add DEBUG logging to silent error handlers (#201)

Documentation & Testing

• JSDoc comments for squad-parser.ts, providers.ts, telemetry.ts
• Unit tests for telemetry, git, memory, auth, lock modules
• Coverage reporting with @vitest/coverage-v8

---

🤖 Generated with Agents Squads

v0.5.0

Highlights

New Features

• Redis distributed locking for safe concurrent memory access
• Docker production configuration for deployment
• Guided interactive onboarding with template system
• Zombie detection and cleanup for tmux sessions
• Local cooldown check for scheduled runs
• Bridge API injection with approval instructions

Bug Fixes

• Handle overnight sessions with proper time comparison
• Correct command syntax for launchd plists
• Use TCP socket for non-HTTP service health checks
• Add --print flag to prevent zombie tmux sessions
• Resolve lint errors blocking CI
• Fix TypeScript strict mode errors

Other

• Migrate ux-tests from hq
• Mark mem0/engram-mcp as optional
• Add squads setup templates to AGENTS.md and CLAUDE.md

Full Changelog

v0.4.13...v0.5.0

v0.4.13

Multi-LLM Provider Support

Choose your LLM provider during init:

squads init --provider gemini   # Google Gemini
squads init --provider openai   # OpenAI
squads init --provider ollama   # Local models
squads init --provider none     # Planning only

Features

• Multi-LLM provider selection during squads init
• Declarative dashboard engine
• Slack notifications in tonight loop
• Git hooks for Slack channel sync

Fixes

• Type definitions for Squad/Agent interfaces
• Weighted token capacity tracking
• Non-TTY detection with --yes flag

v0.4.11 - Learning Loop

Learning Loop

Autonomous learning that compounds across sessions.

Features

• squads learn - Capture insights that persist across sessions
• squads learnings show - View squad learnings with filtering
• squads learnings search - Search across all squads
• Auto-tagging and category inference
• Stop hook prompts for learning capture
• /squads-learn skill for Claude auto-invocation

Categories

• success - What worked well
• failure - What didn't work (learn from mistakes)
• pattern - Reusable approach
• tip - General advice

Documentation

• Learning Loop Guide
• CLI Reference

v0.4.10

What's New

Features

• Complete onboarding experience - squads init now creates everything Claude needs:
  • .claude/skills/squads-workflow/ - Skill teaching the workflow
  • .agents/memory/getting-started/ - Seed memory
  • .agents/BUSINESS_BRIEF.md - Business context template
  • Updated CLAUDE.md with squads context reference
• New squads context command - Get business context for alignment (renamed from context-feed)
• New squads env command - View squad execution environment (MCP, model, budget)
• --force flag for init - Skip requirement checks (useful for CI)

Documentation

• Added missing commands to CLAUDE.md and README (context, history, health, watch, live, top, env, cost, budget, version)
• Added usage examples to squads run --help and squads memory --help

CI Improvements

• Node.js matrix testing (18, 20, 22)
• Security audit (npm audit --audit-level=high)
• Smoke tests for squads init, status, context

Bug Fixes

• Fixed -v/--verbose flag on list command
• Various documentation fixes

Closed Issues

#130, #126, #118, #152, #137, #120, #154, #102, #98, #81, #61, #96, #99, #103, #69, #106

---

🤖 Generated with Agents Squads