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

> All 2 mammoth log commands with examples, arguments and confirmation flags: Locate and read the local run log.

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

Locate and read the local run log. 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 |
|---|---|---|---|
| [`log path`](#mammoth-log-path) | Show the run-log directory, today's file, and the days kept. | Read | — |
| [`log tail`](#mammoth-log-tail) | Read recent run-log records; filter with 'errors_only', 'command_id', 'run_id', 'days'. | Read | — |

## log commands

### mammoth log path

Show the run-log directory, today's file, and the days kept.

```bash
mammoth log path
```

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Id:** `log.path` · **Result:** `LogPathResult`

### mammoth log tail

Read recent run-log records; filter with 'errors_only', 'command_id', 'run_id', 'days'.

```bash
mammoth log tail --input '{"errors_only": true, "limit": 20}'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `days` | `--input` field | no | `1` | `int` |  |
| `limit` | `--input` field | no | `50` | `int` |  |
| `errors_only` | `--input` field | no | `false` | `bool` |  |
| `command_id` | `--input` field | no | — | `str` |  |
| `run_id` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Id:** `log.tail` · **Result:** `LogTailResult`

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