> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buttons.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buttons drawer

> CLI reference for buttons drawer

## buttons drawer

Manage drawer workflows (chains of buttons)

### Synopsis

Manage drawers — typed workflows that chain buttons with
\${ref} references between steps.

Usage:
buttons drawer create NAME
buttons drawer list
buttons drawer NAME add BUTTON \[BUTTON ...]         append button step(s)
buttons drawer NAME add drawer/OTHER                append a sub-drawer step
buttons drawer NAME add for\_each:BUTTON             append a per-item loop wrapping BUTTON
buttons drawer NAME add wait:DURATION               append a time-based pause (e.g. wait:30s)
buttons drawer NAME connect A to B                  auto-match output → args by name+type
buttons drawer NAME connect A.output.x to B.args.y  explicit field path
buttons drawer NAME set STEP.args.FIELD=value       literal or \${ref} into a step arg
buttons drawer NAME set STEP.over=EXPR              for\_each: the array to iterate
buttons drawer NAME set STEP.as=NAME                for\_each: loop variable name
buttons drawer NAME set STEP.parallelism=N          for\_each: max concurrent iterations (0/1 = serial)
buttons drawer NAME set STEP.from=EXPR              aggregate: input array
buttons drawer NAME set STEP.pluck=EXPR             aggregate: per-item expression
buttons drawer NAME set STEP.steps.N.args.F=value   reach a nested step's arg
buttons drawer NAME press \[key=value ...]           run it; unfilled required inputs go here
buttons drawer NAME logs \[--failed] \[--limit N]     past runs for this drawer
buttons drawer NAME remove                          delete the drawer
buttons drawer NAME                                 summary (topology + validation + recent runs)
buttons drawer schema                               print JSON Schema for drawer.json

Typical authoring flow:
buttons drawer create deploy-flow
buttons drawer deploy-flow add build publish
buttons drawer deploy-flow connect build to publish
buttons drawer deploy-flow set publish.args.env=prod
buttons drawer deploy-flow press

```
buttons drawer [flags]
```

### Options

```
  -h, --help   help for drawer
```

### Options inherited from parent commands

```
      --json       output in JSON format
      --no-input   disable all interactive prompts
      --summary    show a read-only plan/snapshot instead of mutating
```

### SEE ALSO

* [buttons](buttons.md)	 - Deterministic workflow engine for agents