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]|agentId> [--name <alias>]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
| <name[:version] | agentId> | string | Required | Agent name, name with version (e.g. my-agent:1.0.0), or 12-character agent ID (from lifectl ai agent list) |
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 by agent ID
lifectl ai agent run a1b2c3d4e5f6
Run with a container alias
lifectl ai agent run my-agent --name my-bot