2.1.33 untested · changelog-derived

Claude Code 2.1.33

**Multi-agent workflow primitives:** New hook events (`TeammateIdle`, `TaskCompleted`) + agent-spawning restrictions (`Task(agent_type)`) + persistent memory scopes (`memory` frontmatter) unlock structured multi-agent orchestration where teammates coordinate across sessions with durable state and controlled delegation.

5 new primitives 2 workflow recipes 12 fixes

New primitives

TeammateIdlehook event

Fires when a teammate agent enters idle state in multi-agent workflows

Added `TeammateIdle` and `TaskCompleted` hook events for multi-agent workflows
TaskCompletedhook event

Fires when a task completes in multi-agent workflows

Added `TeammateIdle` and `TaskCompleted` hook events for multi-agent workflows
Task(agent_type) syntaxcapability

Restricts which sub-agents can be spawned by specifying agent type in agent "tools" frontmatter

Added support for restricting which sub-agents can be spawned via `Task(agent_type)` syntax in agent "tools" frontmatter
memory frontmatter fieldsetting

Enables persistent memory for agents with scope options (`user`, `project`, or `local`)

Added `memory` frontmatter field support for agents, enabling persistent memory with `user`, `project`, or `local` scope
Plugin name in skill menuUI enhancement

Shows plugin name alongside skill descriptions in `/skills` menu for discoverability

Added plugin name to skill descriptions and `/skills` menu for better discoverability

Workflow recipes

Persistent Multi-Agent Task Pipeline
TeammateIdle + TaskCompleted hook events + memory frontmatter (project scope) + Task(agent_type) spawning restrictions

Multi-agent workflows now have state continuity. Agents can persist context across delegations, react to peer lifecycle changes, and enforce spawning policies. This unlocks checkpoint-resumable pipelines where teammates hand off work while preserving shared state without re-initializing each step.

A code-review agent spawns a specialized @syntax-checker sub-agent (via Task(@syntax-checker) restriction) to validate files. When @syntax-checker completes (fires TaskCompleted hook), the reviewer agent wakes up (was idle, receives TeammateIdle→active transition), retrieves shared context from project-scoped memory, and proceeds to semantic review. If the reviewer is interrupted, it resumes from the same checkpoint on re-run because the memory persists in project scope.

Inter-Session Teammate State Machine
memory frontmatter with project scope + TeammateIdle hook + remote sessions (VSCode support)

Agents can now maintain state across separate Claude Code sessions (VSCode remote, tmux, CLI). Hook events enable clean state transitions. Project-scoped memory acts as a durable handoff surface between independently-spawned teammate instances.

A foundational "master coordinator" agent runs in a persistent session and uses project-scoped memory to store a work queue and delegation log. When spawning specialized teammates (e.g., data validator, report generator), each reads their task from memory, processes it, and writes results back. The coordinator watches TeammateIdle events to poll for completion and assign new work. Teammates can be spawned in different sessions/terminals and still coordinate via the shared memory surface — enabling distributed team-like workflows across disconnected Claude Code environments.

Agentic relevance

The multi-agent primitives in 2.1.33 (hook events, memory scoping, spawning restrictions) enable agents to coordinate across sessions with durable state. Agents can now persist context (`user`/`project`/`local` memory), react to teammate lifecycle events, and control which sub-agents they delegate to — transforming ad-hoc teammate spawning into structured orchestration. The tmux fix + remote session support make multi-agent workflows viable in headless and remote environments.

Hardening & fixes (12)

  • Fixed agent teammate sessions in tmux to send and receive messages
  • Fixed warnings about agent teams not being available on your current plan
  • Fixed an issue where submitting a new message while the model was in extended thinking would interrupt the thinking phase
  • Fixed an API error that could occur when aborting mid-stream, where whitespace text combined with a thinking block would bypass normalization and produce an invalid request
  • Fixed API proxy compatibility issue where 404 errors on streaming endpoints no longer triggered non-streaming fallback
  • Fixed an issue where proxy settings configured via `settings.json` environment variables were not applied to WebFetch and other HTTP requests on the Node.js build
  • Fixed `/resume` session picker showing raw XML markup instead of clean titles for sessions started with slash commands
  • Improved error messages for API connection failures — now shows specific cause (e.g., ECONNREFUSED, SSL errors) instead of generic "Connection error"
  • Errors from invalid managed settings are now surfaced
  • VSCode: Added support for remote sessions, allowing OAuth users to browse and resume sessions from claude.ai
  • VSCode: Added git branch and message count to the session picker, with support for searching by branch name
  • VSCode: Fixed scroll-to-bottom under-scrolling on initial session load and session switch

Raw changelog

## 2.1.33

- Fixed agent teammate sessions in tmux to send and receive messages
- Fixed warnings about agent teams not being available on your current plan
- Added `TeammateIdle` and `TaskCompleted` hook events for multi-agent workflows
- Added support for restricting which sub-agents can be spawned via `Task(agent_type)` syntax in agent "tools" frontmatter
- Added `memory` frontmatter field support for agents, enabling persistent memory with `user`, `project`, or `local` scope
- Added plugin name to skill descriptions and `/skills` menu for better discoverability
- Fixed an issue where submitting a new message while the model was in extended thinking would interrupt the thinking phase
- Fixed an API error that could occur when aborting mid-stream, where whitespace text combined with a thinking block would bypass normalization and produce an invalid request
- Fixed API proxy compatibility issue where 404 errors on streaming endpoints no longer triggered non-streaming fallback
- Fixed an issue where proxy settings configured via `settings.json` environment variables were not applied to WebFetch and other HTTP requests on the Node.js build
- Fixed `/resume` session picker showing raw XML markup instead of clean titles for sessions started with slash commands
- Improved error messages for API connection failures — now shows specific cause (e.g., ECONNREFUSED, SSL errors) instead of generic "Connection error"
- Errors from invalid managed settings are now surfaced
- VSCode: Added support for remote sessions, allowing OAuth users to browse and resume sessions from claude.ai
- VSCode: Added git branch and message count to the session picker, with support for searching by branch name
- VSCode: Fixed scroll-to-bottom under-scrolling on initial session load and session switch
All 395 primitives Book a call