ai agent
lifectl ai agent run
Pull the agent if not already local, run the install script (once), then spawn a new detached container process using the start script from agent.json. Prints the container ID on success. Similar to docker run.
Synopsis
lifectl ai agent run <name[:version]> [--name <alias>]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
| <name[:version]> | string | Required | Agent name and optional version tag (e.g. my-agent or my-agent:1.0.0) |
Options
| Flag | Type | Default | Description |
|---|---|---|---|
| --name | string | — | Assign a human-readable alias to the container |
Examples
Run the latest version
lifectl ai agent run my-agent
Run a specific version
lifectl ai agent run my-agent:1.0.0
Run with a container alias
lifectl ai agent run my-agent --name my-bot