working_directory

The workflow-level working_directory field sets the default directory in which workflow steps run.

workflows:
  build-all:
    working_directory: !repo-root
    steps:
      - command: make build
        type: shell
      - command: make test
        type: shell

Path Resolution

• Absolute paths are used as-is.
• Relative paths are resolved by Atmos from the configured base path context.
• The !repo-root YAML function resolves to the Git repository root.

Step-level working_directory overrides the workflow-level value for that step.

When a workflow-level container is configured, working_directory remains a host-side Atmos path. Atmos maps it into the configured container workspace before running the command.