Initialize

Run donmai init in any directory. This creates ~/.donmai/config.toml if it does not exist and scaffolds a starter workflow.toml in the current directory.

donmai init

Output:

donmai: initialized config at ~/.donmai/config.toml
donmai: created workflow.toml in ./

Config file

~/.donmai/config.toml holds your global configuration. A minimal config looks like:

[daemon]
log_level = "info"

[runtime]
default_provider = "local"

See the configuration reference for the full key set.

Write a workflow

Open workflow.toml in your editor. A minimal workflow with two steps:

[workflow]
name = "hello-world"
version = "0.1.0"

[[steps]]
id    = "greet"
type  = "shell"
run   = "echo 'hello from donmai'"

[[steps]]
id      = "done"
type    = "shell"
run     = "echo 'workflow complete'"
depends = ["greet"]

Run

donmai run

donmai picks up workflow.toml in the current directory by default. Pass a path explicitly with --workflow:

donmai run --workflow path/to/workflow.toml

You will see step-level output as each step executes. When the workflow completes, exit code 0 means success.

Next steps

• Configure providers and plugins: Configuration reference
• Extend donmai with plugins: Plugins overview
• Browse built-in workflow nodes: Built-in nodes