> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://mammoth.io/docs/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown.

# mammoth recipe

> All 2 mammoth recipe commands with examples, arguments and confirmation flags: Run a common multi-step task as one command.

> Generated from mammoth-cli 2.4.2, released 2026-11-02: `mammoth schema list`, `mammoth capability list` and the CLI's own `--help`. Do not edit by hand; run `npm run docs:capabilities`.

Run a common multi-step task as one command. 2 commands.

Every command also takes the [global flags](https://mammoth.io/docs/build/cli/global-flags/) (`--output`, `--yes`, `--confirm`, `--dry-run`, `--input`, `--profile`, ...), which are not repeated below. `--input` takes a JSON or YAML document of the input fields; `mammoth schema get COMMAND_ID` prints a command's full input schema.

**Confirmation.** Commands marked `--yes --confirm TARGET` or `--yes` always need those flags, even at a terminal: they never prompt. Commands marked "`--yes` or prompt" ask at an interactive terminal (table output, no `--no-input`) and otherwise need `--yes`. `--dry-run` skips confirmation and sends nothing.

## Summary

| Command | What it does | Effect | Confirmation |
|---|---|---|---|
| [`recipe list`](#mammoth-recipe-list) | List the recipes 'recipe run' can run, with their inputs and a ready command. | Read | — |
| [`recipe run`](#mammoth-recipe-run) | Run a recipe's steps in one process; 'inputs' fills them. Prompt or '--yes'. | High impact | `--yes` or prompt |

## recipe commands

### mammoth recipe list

List the recipes 'recipe run' can run, with their inputs and a ready command.

```bash
mammoth recipe list
```

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Id:** `recipe.list` · **Result:** `RecipeListResult`

### mammoth recipe run

Run a recipe's steps in one process; 'inputs' fills them. Prompt or '--yes'.

```bash
mammoth recipe run export-csv --input '{"inputs": {"view_id": 1, "dataset_id": 2}}' --yes
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `ID` | positional | yes | — | `str` | The recipe to run (from 'recipe list'). |
| `inputs` | `--input` field | no | — | `dict[str, any]` |  |

- **Effect:** High impact, scope `profile` · **Confirmation:** `--yes`, or answer the prompt at an interactive terminal
- **Preconditions:** Runs only the recipes 'recipe list' shows. Stops at the first failed step; 'mammoth history undo' with the run's group reverses the writes. Not available embedded.
- **Id:** `recipe.run` · **Result:** `RecipeRunResult`

---
Source: https://mammoth.io/docs/build/cli/recipe.md · Updated: 2026-11-02
