Skip to content
Build with Mammoth › CLI reference: open the docs menu

mammoth history

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.

List the writes made from this machine, undo them, and resume a stopped run. 4 commands.

Every command also takes the 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

CommandWhat it doesEffectConfirmation
history listList the journaled writes, newest first; filter with 'limit', 'undoable_only'.Read—
history resumeGo on with a stopped run (by its group) from its first unfinished line. Prompt or '--yes'.High impact--yes or prompt
history showShow one write (by inv) or every write of one run (by group), with their undo lines.Read—
history undoUndo one write (by inv) or a whole run (by group), newest first. Prompt or '--yes'.High impact--yes or prompt

history commands

mammoth history list

List the journaled writes, newest first; filter with 'limit', 'undoable_only'.

mammoth history list --input '{"undoable_only": true}'
NamePassed asRequiredDefaultTypeNotes
limit--input fieldno20int
undoable_only--input fieldnofalsebool
  • Effect: Read, scope profile · Confirmation: none
  • Preconditions: Lists writes made from this machine only. Not available embedded.
  • Id: history.list · Result: HistoryListResult

mammoth history resume

Go on with a stopped run (by its group) from its first unfinished line. Prompt or '--yes'.

mammoth history resume 97b9ee41d15d --yes
NamePassed asRequiredDefaultTypeNotes
IDpositionalyes—strThe group of the mammoth run or recipe run that stopped (from 'history list').
from_line--input fieldno—int
  • Effect: High impact, scope profile · Confirmation: --yes, or answer the prompt at an interactive terminal
  • Preconditions: Resumes a mammoth run or recipe run started on this machine with the journal on. A named result larger than 256 KB is not kept, so a later line that reads it fails. Refuses when a write's outcome is unknown until from_line names where to start. Not available embedded.
  • Id: history.resume · Result: HistoryResumeResult

mammoth history show

Show one write (by inv) or every write of one run (by group), with their undo lines.

mammoth history show 97b9ee41d15d
NamePassed asRequiredDefaultTypeNotes
IDpositionalyes—strThe write's inv, or the group of a whole mammoth run (from 'history list').
  • Effect: Read, scope profile · Confirmation: none
  • Preconditions: Not available embedded.
  • Id: history.show · Result: HistoryShowResult

mammoth history undo

Undo one write (by inv) or a whole run (by group), newest first. Prompt or '--yes'.

mammoth history undo 97b9ee41d15d --yes
NamePassed asRequiredDefaultTypeNotes
IDpositionalyes—strThe write's inv, or the group of a whole mammoth run (from 'history list').
force--input fieldnofalsebool
  • Effect: High impact, scope profile · Confirmation: --yes, or answer the prompt at an interactive terminal
  • Preconditions: Undoes pipeline edits (back to the version before), objects a write created (to the trash) and moves to the trash (restored). Permanent deletes and external effects (exports, sends) cannot be undone and are reported. Not available embedded.
  • Id: history.undo · Result: HistoryUndoResult

Report an issue · support@mammoth.io