Quickstart

This quickstart runs a local script component, captures an output, inspects state, and tears the environment down.

Install Orch

curl -fsSL https://tryorch.dev/install | sh

Create A Manifest

Generate a starter manifest:

orch init --id hello

Or create orch.yaml manually:

version: orch/1.0

metadata:
  id: hello
  description: Local script example
  owner:
    name: Orch
    email: orch@example.com

runners:
  local:
    type: local
    config: {}

components:
  hello:
    type: script
    runner: local
    source:
      embedded: |
        echo "message=hello from orch" >> "$ORCH_OUTPUT_ENV"
    outputs:
      - name: message

Apply

orch up --env-id demo

Orch applies the component and writes state under .orch/demo by default.

Inspect

orch state inspect --env-id demo

The default table output shows component status, stage, type, runner, and timestamps. It intentionally does not print outputs, payloads, or artifact contents.

Destroy

orch down --env-id demo

After a successful destroy, Orch deletes the whole environment state bundle, including artifacts.