Start the agent host or manage host operations
Start the agent host that connects Mutiro messaging to a chat brain.
The host provides a gRPC service that can:
- Connect to the Mutiro messaging service for real-time conversation participation
- Preprocess inbound message artifacts such as attachments and audio
- Deliver observed message facts to a chat brain over the chat bridge
- Run with a built-in loopback brain or an internal stdio transport
Configuration is loaded from .mutiro-agent.yaml in the current directory. Use --config flag to specify a different agent configuration file.
Modes: --mode=host Start the normal agent host --mode=bridge Serve the host bridge over stdio for an external brain
Transport: --transport=loopback|stdio Internal host-to-brain transport in host mode
mutiro agent host [flags]
| Flag | Type | Description |
|---|---|---|
| --api-endpoint | string | API endpoint override for bridge mode |
| --api-key | string | API key for bridge mode agent authentication |
| -h, --help | bool | help for host |
| --insecure | bool | Disable TLS in bridge mode |
| --log-file | string | Path to log file (use '-' to disable file logging) |
| --log-file-format | string | Log file format (json|text) (default "text") |
| --log-file-max-age int | bool | Maximum number of days to retain old log files (default 30) |
| --log-file-max-backups int | bool | Maximum number of rotated log files to keep (default 5) |
| --log-file-max-size int | bool | Maximum size in MB before rotating the log file (default 50) |
| --log-format | string | Log format for stdout (json|text) (default "json") |
| --log-level | string | Log level (trace|debug|info|warn|error) (default "info") |
| --mode | string | Host mode (host|bridge) (default "host") |
| --trace[="full"] | string | Record genie session traces under <agent dir>/.genie/sessions (standard|full; bare --trace means full) |
| --transport | string | Internal host transport (loopback|stdio) |
| --username | string | Agent username override for bridge mode |
| Flag | Type | Description |
|---|---|---|
| --config | string | config file (default is ./.mutiro.yaml in current directory) |
| --debug | bool | debug mode |
| -v, --verbose | bool | verbose output |