Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Manage durable runs in the entered workspace
idyl run
| Command | Description |
|---|---|
idyl run create | Create a run from the current workspace revision |
idyl run get | Get a workspace run |
idyl run list | List workspace runs |
idyl run logs | Show logs from the latest run attempt |
idyl run resume | Resume a workspace run |
idyl run shell | Open a shell in the latest run attempt |
idyl run stop | Stop a workspace run |
| Flag | Description |
|---|---|
-a <string>, --account-id <string> | Account ID to use, overriding the current context. |
-c <string>, --context <string> | Use the named context for this command. |
--homedir <string> | Override the configuration directory. Defaults to ~/.config/idyl. |
-n <string>, --namespace <string> | Namespace to address, overriding the entered context. |
--network <string> | Override the Network for this command. |
-p <string>, --profile <string> | Override the access profile for this command. |
-s <string>, --subnet <string> | Subnet to use for this command, overriding the current context. |
--workspace <string> | Workspace within the namespace, overriding the entered context. |
idyl run createidyl run create -- COMMAND [ARG...] [flags]
| Flag | Description |
|---|---|
-e <stringArray>, --env <stringArray> | Environment variable in KEY=VALUE form; repeatable. |
--image <string> | Container image URI. Uses the Workspace default when omitted. |
-o <string>, --output <string> | Output format: table, json, yaml. Default: table. |
idyl run create -- python main.py
idyl run create --image python:3.13 --env MODE=check -- python main.py --check
idyl run getidyl run get <run-id> [flags]
| Flag | Description |
|---|---|
-o <string>, --output <string> | Output format: table, json, yaml. Default: table. |
idyl run listidyl run list [flags]
| Flag | Description |
|---|---|
--limit <int> | Maximum number of runs to list. Default: 20. |
--offset <int> | Number of runs to skip. Default: 0. |
-o <string>, --output <string> | Output format: table, json, yaml. Default: table. |
idyl run logsidyl run logs <run-id> [flags]
| Flag | Description |
|---|---|
--container <string> | Container name. |
-f, --follow | Stream new log lines as they arrive. |
--previous | Read logs from the previous container instance when available. |
--since <duration> | Only return logs newer than this duration. Default: 0s. |
--stream <string> | Log stream selector: all, stdout, or stderr. Default: all. |
--tail <int64> | Number of recent log lines to show. Default: 0. |
--timestamps | Include provider timestamps when available. |
idyl run resumeidyl run resume <run-id> [flags]
| Flag | Description |
|---|---|
-o <string>, --output <string> | Output format: table, json, yaml. Default: table. |
idyl run shellidyl run shell <run-id> [flags]
| Flag | Description |
|---|---|
--container <string> | Exact container name. |
--port <string> | Raw SSH port: auto, 22, or 443. Default: auto. |
--shell <string> | Absolute shell executable in the container. Default: /bin/sh. |
idyl run stopidyl run stop <run-id> [flags]
| Flag | Description |
|---|---|
-o <string>, --output <string> | Output format: table, json, yaml. Default: table. |