> 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.

# Other commands

> 10 mammoth CLI commands from single-command families, such as doctor, how, run and upgrade, with examples and arguments.

> 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`.

10 commands that are a family of one. API operations with no CLI command are listed on the [capability contract](https://mammoth.io/docs/build/contract/) page.

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 |
|---|---|---|---|
| [`calc`](#mammoth-calc) | Evaluate one arithmetic expression exactly. | Read | — |
| [`capabilities`](#mammoth-capabilities) | List what the CLI cannot do yet, and what to do instead. | Read | — |
| [`doctor`](#mammoth-doctor) | Run environment and connectivity diagnostics. | Read | — |
| [`how`](#mammoth-how) | Turn a plain-language goal into an ordered recipe of commands. | Read | — |
| [`link`](#mammoth-link) | Read the workspace, project, folder, dataset and view ids out of a pasted app URL. | Read | — |
| [`report list`](#mammoth-report-list) | List reports in the active workspace, with optional 'limit'/'offset'. | Read | — |
| [`resolve`](#mammoth-resolve) | Say what NAME refers to: a dataset, a view or a project, with ids and projects. | Read | — |
| [`run`](#mammoth-run) | Run many commands in one process: JSON Lines of cmd, args, input and flags. | Read | — |
| [`upgrade`](#mammoth-upgrade) | Upgrade the mammoth CLI to the latest (or a specified) version from PyPI. | External effect | `--yes` or prompt |
| [`version`](#mammoth-version) | — | Read | — |

## Commands

### mammoth calc

Evaluate one arithmetic expression exactly.

```bash
mammoth calc '2063664 - 1917815'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `EXPRESSION` | positional | yes | — | `str` | Arithmetic expression: + - \* / and parentheses, unary +/-, a trailing %% (divides by 100), and round(x\[, ndigits\]). |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Every number reported to the user comes from a tool result: use calc for a single expression, view data compare for a per-key comparison across two views. Never compute a difference or percentage mentally.
- **Id:** `calc` · **Result:** `CalcResult`

### mammoth capabilities

List what the CLI cannot do yet, and what to do instead.

```bash
mammoth capabilities
```

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Lists only the known gaps. A goal it does not name may simply be supported; run mammoth how GOAL or mammoth schema find WORDS.
- **Id:** `capabilities` · **Result:** `CapabilitiesResult`

### mammoth doctor

Run environment and connectivity diagnostics.

```bash
mammoth doctor
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `wait` | `--input` field | no | `0` | `int` |  |

- **Effect:** Read, scope `local` · **Confirmation:** none
- **Preconditions:** Prints the report either way; exits 4 when the report's ok is false.
- **Id:** `doctor` · **Result:** `DoctorResult`

### mammoth how

Turn a plain-language goal into an ordered recipe of commands.

```bash
mammoth how 'refresh a dataset daily'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `GOAL` | positional | yes | — | `str` | The goal in plain words, for example "refresh a dataset daily" or "blend two files by day". |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Required inputs: GOAL.
- **Id:** `how` · **Result:** `HowResult`

### mammoth link

Read the workspace, project, folder, dataset and view ids out of a pasted app URL.

```bash
mammoth link https://app.mammoth.io/workspaces/1/projects/2/data/datasets
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `URL` | positional | yes | — | `str` | A Mammoth web app address pasted by the user. |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Folder and selected ids in a link are web app resource ids, not dataset or view ids; only /datasets/ID and /views/ID links carry those directly.
- **Id:** `link` · **Result:** `LinkResult`

### mammoth report list

List reports in the active workspace, with optional 'limit'/'offset'.

```bash
mammoth report list
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `limit` | `--input` field | no | `50` | `int` |  |
| `offset` | `--input` field | no | `0` | `int` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `offset`
- **Id:** `report.list` · **Result:** `ReportListResult` · **Backed by:** SDK `mammoth.api.reports.ReportsAPI.list`, API `GET /reports` (GetReports)

### mammoth resolve

Say what NAME refers to: a dataset, a view or a project, with ids and projects.

```bash
mammoth resolve uqa-w29-ren
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `NAME` | positional | yes | — | `str` | Case-insensitive name, or part of one, to look up as a dataset, view or project. |
| `all_projects` | `--input` field | no | `false` | `bool` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Required inputs: NAME.
- **Id:** `resolve` · **Result:** `ResolveResult`

### mammoth run

Run many commands in one process: JSON Lines of cmd, args, input and flags.

One command per line: {"cmd": "view task list", "args": \["290"\], "input": {}, "flags": {"project": 1}, "id": "a"}. cmd is the command path, args its positionals, input its --input document, flags the global flags by long name (yes, confirm, dry-run, project). Prints each line's envelope plus line, cmd and exit, then a summary; stops at the first failed line (exit = its status) unless --continue. No global --yes: a mutating line carries its own. --dry-run, --profile and --project apply to every line. FILE defaults to stdin; --continue may come before or after it. Steps: name a line ("name": "up") and a later line reads its result as "{{steps.up.data.dataset.id}}" in args, input or flags; "when": {"eq": \[A, B\]} skips a line; "for_each": "{{steps.ls.data}}" runs it once per item ("{{item}}", "{{index}}"). JSON expressions only, no code.

```bash
mammoth run commands.jsonl
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `FILE` | positional | no | — | `str` | JSON Lines file with one command per line, or '-' (the default) for stdin. |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** run has no global --yes or --confirm; a mutating line carries its own in flags. Not available embedded.
- **Id:** `run` · **Result:** `RunResult`

### mammoth upgrade

Upgrade the mammoth CLI to the latest (or a specified) version from PyPI.

```bash
mammoth upgrade --yes
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `--check` | flag | no | — | `flag` | Report installed vs latest version; make no changes. |
| `--version` | flag | no | — | `str` | Upgrade to this exact version instead of the latest. |

- **Effect:** External effect, scope `profile` · **Confirmation:** `--yes`, or answer the prompt at an interactive terminal
- **Preconditions:** Installs a different mammoth CLI version from PyPI over the current one. Run `mammoth version` first. Needs a prompt or --yes; the install is skipped when the version is already current.
- **Id:** `upgrade` · **Result:** `UpgradeResult`

### mammoth version

*The CLI gives this command no description.*

```bash
mammoth version
```

- **Effect:** Read, scope `local` · **Confirmation:** none
- **Id:** `version` · **Result:** `VersionResult`

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