Creating Agents

From a Template

naos create my-agent --template researcher

Available templates:

Template	Description
`researcher`	Web research and summarization
`analyzer`	Data analysis and reporting
`coder`	Code generation and review
`planner`	Task planning and decomposition
`custom`	Blank template

From Configuration

Define agents in nexus.config.yaml:

agents:
  researcher:
    template: researcher
    autoStart: true
  analyzer:
    template: analyzer
    env:
      MODEL: claude-3-sonnet

Then create all configured agents:

naos create --from-config

Verify Creation

naos status

# NAME         STATUS    ID
# researcher   stopped   a1b2c3d4e5f6
# analyzer     stopped   b2c3d4e5f6a1

Agent Naming Rules

Lowercase letters, numbers, and hyphens only
Must start with a letter
Maximum 64 characters
Must be unique within the project

# ✓ Valid names
naos create my-agent
naos create data-processor-v2
naos create agent123

# ✗ Invalid names
naos create My-Agent        # uppercase
naos create 123-agent       # starts with number
naos create my_agent        # underscores