Skip to main content
A Run names a fixed population pinned to one Agent Revision. Listing or reading Runs or their members allocates no Actor execution. Creation progress is independent of later invocation results. Deleting a Run removes only its population handle.

Usage

Aliases

  • runs

Commands

Inherited flags

Subcommand reference

idyl run delete

Delete a Run’s population handle and record when it was deleted. Nothing else is removed: the Run’s Actors, their Revision pins and saved files, and operations already accepted against its members remain readable by ID and continue as admitted. Delete Actors with ‘idyl actor delete’. Repeating the command is safe. You will be prompted for confirmation unless the —yes flag is provided.

Usage

Aliases

  • rm

Flags

Examples

idyl run get

Read population creation progress

Usage

Flags

idyl run invoke

Admit one JSON input for a fixed index range of a Run and return the durable invocation round before members, capacity or execution are ready. Members still being created receive the input once their Actor exists; a member whose creation failed records an explicit failure instead of being skipped. The input file is data, never shell source. Retry an uncertain response with the same input, range and idempotency key. Without —start and —end the round covers every member of the Run.

Usage

Flags

idyl run list

List one cursor page of the Runs in the selected Namespace and Subnet, newest first. —agent keeps the Runs of the named Agent, read once to its stable ID; —agent-id names that ID directly. —revision keeps the Runs pinned to one Revision. Runs whose population handle was deleted are listed only with —include-deleted. Use —continue with the returned cursor, and the same filters, for the next page. Reading a page allocates no Actor execution. JSON and YAML retain the exact totalCount and member count strings.

Usage

Aliases

  • ls

Flags

Examples

idyl run members

List one cursor page, including fixed indices whose Actors are not ready. Use the opaque continuation unchanged to request the next page. A page size bounds a response and does not limit the population. Counts and indices remain exact decimal strings in JSON and YAML.

Usage

Flags