.aether Language

Basics

A .aether document is a YAML-like manifest that declares chains of steps. Minimal header:

# hello.aether
name: hello-world
version: 0.1.0
description: Simple demo chain

chains:
    - id: greet
        steps:
            - use: echo
                with:
                    text: "Hello, Aetherra!"

Manifest fields

• name (string)
• version (semver)
• description (string, optional)
• chains[].id (string, required)
• chains[].steps[].use — capability or plugin to invoke
• chains[].steps[].with — input parameters

Types

• string, number, boolean
• object (mapping), array (sequence)
• null

Variables and interpolation

steps:
    - use: fetch
        as: data
        with: { url: "https://example.com/data.json" }
    - use: transform
        with:
            input: ${data.body}

Error Reference

• Unknown field: remove or move the key under with:.
• Invalid type: ensure types match the capability schema (e.g., string vs object).
• Unknown capability: verify the plugin providing use: is installed and enabled.
• Interpolation failed: referenced variable not defined; check prior step as: names.

Try it

1. Create a file hello.aether with the example above.
2. Start the Hub and OS. In the widget, set your Hub URL (Ctrl‑click the title) and then use the task watcher to stream a run of hello.aether.

See also: Runtime & CLI · Recipes