The @task decorator is used to define automation metadata and information about the runtime environment that will be provisioned to execute it. 
@task(
    name="my-automation",
    plugins=["CLAUDE_CODE"],
    required_env_vars=["CLAUDE_API_KEY"]
    runner="small.cpu",
    runtime="python3.10",
)
The only required argument for the @task decorator is the name argument. The name must be unique per workspace; changing the name will create a new automation or overwrite an existing automation if the name already exists.

​
Arguments

​
name
string
required
The name of the automation.
​
plugins
array
The plugins to install in the automation. Supported values: CLAUDE_CODE.
  • CLAUDE_CODE adds Node to your automation’s runtime and installs the Claude CLI.
​
required_env_vars
array
The environment variables that are required to run your automation. Automations cannot be enabled when these are not defined.
​
runner
string
default:"small.cpu"
The runner to use for the automation. Supported values: small.cpu, medium.cpu, large.cpu, xlarge.cpu.
GPU runners are available on request. Please reach out to us at support@blocksorg.com to request access.
​
runtime
string
default:"python3.10"
The runtime to use for the automation. Supported values: python3.9, python3.10, python3.11, python3.12.