Skip to content

Worker Configuration

Workers are agents that are registered as tools with a parent agent, allowing for hierarchical agent structures. They can be configured using either detailed configuration or shorthand syntax.

Basic Configuration

Simple worker by name: 

agents:
  senior_dev:
    workers:
      - "code_reviewer"     # Simple reference to another agent
      - "bug_analyzer"      # Each becomes available as a tool

Detailed Configuration

Full worker configuration with all options: 

agents:
  senior_dev:
    workers:
      - name: "code_reviewer"
        reset_history_on_run: true    # Fresh conversation each time
        pass_message_history: false   # Don't share parent's history
        share_context: false          # Don't share parent's context/deps

      - name: "bug_analyzer"
        reset_history_on_run: false   # Maintain conversation between runs
        pass_message_history: true    # See parent's conversation
        share_context: true           # Access parent's context data

Configuration Options

reset_history_on_run

  • true (default): Start fresh conversation for each invocation
  • false: Maintain conversation context between runs

pass_message_history

  • true: Worker sees parent's conversation history
  • false (default): Worker only sees current request

share_context

  • true: Worker has access to parent's context/dependencies
  • false (default): Worker uses own isolated context

Usage Examples

Independent Workers

Workers that operate independently: 

agents:
  lead_dev:
    workers:
      - name: "linter"
        reset_history_on_run: true     # Fresh start each time
        pass_message_history: false    # Independent operation
        share_context: false           # Own context

Context-Aware Workers

Workers that share context with parent: 

agents:
  architect:
    workers:
      - name: "code_reviewer"
        reset_history_on_run: false    # Remember previous reviews
        pass_message_history: true     # See full discussion
        share_context: true            # Access shared context

Mixed Team

Different workers with different settings: 

agents:
  team_lead:
    workers:
      # Independent linting
      - name: "linter"
        reset_history_on_run: true

      # Contextual code review
      - name: "reviewer"
        reset_history_on_run: false
        pass_message_history: true

      # Simple reference to existing agent
      - "formatter"