The Archive · CLI reference · Commands

talos checkpoint

The file checkpoints TALOS takes before it changes files: list, show, undo, redo.

Reference for TALOS CLI 0.3.3 generated from the npm package · released Sep 30, 2026

TALOS CLI 0.5.2 is out; this page still describes 0.3.3 and updates with the next build.

Before a turn changes files, TALOS saves what it will touch, outside your repository and outside Git. /undo in the interactive screen uses the same checkpoints.

Operation	What it does
`list`	Lists the checkpoints of the project, newest first.
`show`	Shows a checkpoint: operation, state, files covered and files excluded.
`undo`	Restores the files as they were before a checkpoint; without an id, the latest.
`redo`	Applies again the changes an undo removed; without an id, the latest.

`list`

Lists the checkpoints of the project, newest first.

talos checkpoint list

`show`

Shows a checkpoint: operation, state, files covered and files excluded.

talos checkpoint show <id>

Arguments

id: The id talos checkpoint list shows.

`undo`

Restores the files as they were before a checkpoint; without an id, the latest.

talos checkpoint undo [id]

Arguments

idoptional: Checkpoint id.

Refused while a session is running.

Exit codes and errors1

Code	Exit	Meaning
`CHECKPOINT_ACTIVE_RUN_CONFLICT`	`70`	TALOS could not finish this action. Try again; if it happens again, keep the log for a report.

`redo`

Applies again the changes an undo removed; without an id, the latest.

talos checkpoint redo [id]

Arguments

idoptional: Checkpoint id.

Refused while a session is running.

Exit codes and errors1

Code	Exit	Meaning
`CHECKPOINT_ACTIVE_RUN_CONFLICT`	`70`	TALOS could not finish this action. Try again; if it happens again, keep the log for a report.