Create a new AI agent with the specified username and display name.

If no arguments are provided, an interactive wizard will guide you through the process.

The username must be unique and will be used to reference the agent. The display name is what users will see when interacting with the agent. Agents use Mutiro-hosted runtime by default.

Pass --self-hosted when you want to run the daemon yourself with a local config file.

Examples:

Interactive mode - prompts for all details

mutiro agents create

Non-interactive mode with arguments

mutiro agents create my-assistant "My AI Assistant"

Create with metadata

mutiro agents create assistant "My Assistant" --metadata version=1.0

Multiple metadata values

mutiro agents create helper "Helper Bot"
--metadata version=1.0
--metadata owner=team-alpha

Self-hosted with config saved to custom file

mutiro agents create helper "Helper Bot" --self-hosted -f my-agent-config.yaml

Self-hosted without saving config file

mutiro agents create helper "Helper Bot" --self-hosted --no-config

Create with an objective seed for generated bio/instructions

mutiro agents create helper "Helper Bot" --objective "Help me triage support issues and draft clear replies"

Create from a template directory

mutiro agents create --from ./my-template

Create from template with self-hosted test-engine override

mutiro agents create --from ./my-template my-bot "Override Name" --engine echo --self-hosted

Create with a badge

mutiro agents create helper "Helper Bot" --badge lobster

Explicitly use Mutiro-hosted runtime (this is the default)

mutiro agents create helper "Helper Bot" --hosted

Create as self-hosted and run the daemon yourself

mutiro agents create helper "Helper Bot" --self-hosted

mutiro agents create [agent-username] [display-name] [flags]