Create a new AI agent
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.
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 specific engine type
mutiro agents create assistant "My Assistant" --engine genie
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
Save config to custom file
mutiro agents create helper "Helper Bot" -f my-agent-config.yaml
Create without saving config file
mutiro agents create helper "Helper Bot" --no-config
Create with a bio
mutiro agents create helper "Helper Bot" --bio "A friendly assistant"
Create from a template directory
mutiro agents create --from ./my-template
Create from template with CLI overrides
mutiro agents create --from ./my-template my-bot "Override Name" --engine claude
mutiro agents create [username] [display-name] [flags]
Interactive mode - prompts for all details
Non-interactive mode with arguments
Create with specific engine type
Create with metadata
Multiple metadata values
Save config to custom file
Create without saving config file
Create with a bio
Create from a template directory
Create from template with CLI overrides
| Flag | Type | Description |
|---|---|---|
| --bio | string | Agent bio/description |
| --engine | string | Agent engine type (echo, genie, claude, codex) - auto-detected if not specified |
| -f, --file | string | Output agent configuration to file (default ".mutiro-agent.yaml") |
| --from | string | Create agent from a template directory |
| -h, --help | bool | help for create |
| --metadataArray | string | Metadata key=value (can be repeated, max 16KB total) |
| --no-config | bool | Don't save configuration file |
| Flag | Type | Description |
|---|---|---|
| --config | string | config file (default is ./.mutiro.yaml in current directory) |
| --debug | bool | debug mode |
| -v, --verbose | bool | verbose output |