> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage runtimes

The `runtime` command group manages AgentKit runtimes, covering listing, inspection, log retrieval, version history, releasing, updating, and deletion.

## runtime list

List all runtimes.

| Flag / Argument | Description | Default |
| - | - | - |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `-p, --project <name>` | Project name. | default |
| `--json` | Output raw JSON. | `false` |

```bash lines theme={null}
agentkit runtime list --project demo
```

## runtime show

Show details of a runtime, optionally a specific version.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `--rev <n>` | Show a specific version instead of the current one. | current |
| `--json` | Output raw JSON. | `false` |

```bash lines theme={null}
agentkit runtime show my-agent --rev 3
```

## runtime delete

Delete a runtime.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `-y, --yes` | Skip the confirmation prompt. | `false` |

```bash lines theme={null}
agentkit runtime delete my-agent --yes
```

## destroy

Delete the deployed runtime. This performs the same underlying operation as `runtime delete`, but serves a different scenario: `destroy` is the inverse of `deploy` and needs no explicit runtime — when no name is given, it resolves the runtime deployed from the current project in order from the command-line argument, `.agentkit/agentkit.yaml`, then `harness.yaml`, and deletes it. It is meant for tearing down what the current project deployed, from inside the project directory. `runtime delete`, by contrast, is a runtime-management operation: it requires an explicit runtime id or name, can delete any runtime, and does not depend on local project configuration.

| Flag / Argument | Description | Default |
| - | - | - |
| `[name]` | Runtime name. Resolved from local config when omitted. | from local config |
| `-r, --region <region>` | Volcengine region. | auto-sense |
| `-y, --yes` | Skip confirmation. | `false` |

```bash lines theme={null}
# Inside a project directory, delete the runtime this project deployed
agentkit destroy

# Or target a runtime by name
agentkit destroy my-agent --yes
```

## runtime logs

Show logs for a runtime instance.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `-i, --instance <name>` | Instance name. | auto-resolve |
| `-n, --limit <n>` | Number of log lines; `0` = all. | server-side |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `--json` | Output raw JSON. | `false` |

```bash lines theme={null}
agentkit runtime logs my-agent --limit 200
```

## runtime attach

Open an interactive terminal inside a running instance of the runtime, the same shell the console's instance terminal provides. Press Ctrl-] to detach, which leaves the instance running. When the runtime has scaled to zero and has no instance, one is started automatically before attaching; a runtime using `custom_jwt` authentication cannot be auto-started without a token, so invoke it once first.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `-i, --instance <name>` | Instance to attach to; otherwise a ready instance is used, and you are prompted when several exist. | auto-resolve |
| `-r, --region <region>` | Volcengine region. | auto-detect |

```bash lines theme={null}
agentkit runtime attach my-agent
```

## runtime versions

List a runtime's version history.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `--json` | Output raw JSON. | `false` |

```bash lines theme={null}
agentkit runtime versions my-agent
```

## runtime release

Release (publish) a runtime version, making it live.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `--rev <n>` | Version number to release. | latest |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `--no-wait` | Return immediately instead of waiting for `Ready`. | `false` |

```bash lines theme={null}
agentkit runtime release my-agent --rev 3
```

## runtime update

Update a runtime's configuration. This does not release the new version unless `--auto-release` is passed.

| Flag / Argument | Description | Default |
| - | - | - |
| `<runtime>` | Runtime id (`r-...`) or name. Required. | — |
| `--description <text>` | Description. | — |
| `--artifact-url <url>` | Container image url. | — |
| `--artifact-type <type>` | Artifact type. | — |
| `--cpu-milli <n>` | CPU in milli-cores. | — |
| `--memory-mb <n>` | Memory in MB. | — |
| `--min-instance <n>` | Minimum instances. | — |
| `--max-instance <n>` | Maximum instances. | — |
| `--max-concurrency <n>` | Maximum concurrency per instance. | — |
| `--model-agent-name <name>` | Model agent name. | — |
| `--knowledge-id <id>` | Associated knowledge base id. | — |
| `--memory-id <id>` | Associated memory collection id. | — |
| `--tool-id <id>` | Associated tool id. | — |
| `--mcp-toolset-id <id>` | Associated MCP toolset id. | — |
| `--apmplus` | Enable APMPlus monitoring. | — |
| `--no-apmplus` | Disable APMPlus monitoring. | — |
| `--envs-json <json>` | Env vars as a JSON array, e.g. `'[{"Key":"K","Value":"V"}]'`. | — |
| `--tags-json <json>` | Tags as a JSON array. | — |
| `--json <jsonString>` | Advanced: JSON object merged into the request body. | — |
| `-r, --region <region>` | Volcengine region. | auto-detect |
| `--auto-release` | Release the new version immediately after updating. | `false` |
| `--no-wait` | Return immediately instead of waiting for the runtime to settle. | `false` |

```bash lines theme={null}
agentkit runtime update my-agent --cpu-milli 1000 --memory-mb 2048 --auto-release
```