atuin history
Manipulate shell history
atuin history <COMMAND>atuin history start
Section titled “atuin history start”Begins a new command in the history
atuin history start [OPTIONS] [COMMAND]...Arguments
Section titled “Arguments”<COMMAND>...
Options
Section titled “Options”-
--author <AUTHOR>: Author of this command, egellie,claude, orcopilot -
--author-kind <AUTHOR_KIND>: Whether a human or an AI agent ran this commandWithout it, Atuin makes a best guess.
user: A human ran this commandagent: An AI agent ran this command
-
--intent <INTENT>: Optional intent/rationale for running this command
atuin history end
Section titled “atuin history end”Finishes a new command in the history (adds time, exit code)
atuin history end [OPTIONS] --exit <EXIT> <ID>Arguments
Section titled “Arguments”<ID>
Options
Section titled “Options”-e <EXIT>,--exit <EXIT>: Required.-d <DURATION>,--duration <DURATION>
atuin history tail
Section titled “atuin history tail”Stream history events from the daemon as they are received
atuin history tailatuin history list
Section titled “atuin history list”List all items in history
atuin history list [OPTIONS]Options
Section titled “Options”-
-c,--cwd -
-s,--session -
--human -
--cmd-only: Show only the text of the command -
--print0: Terminate the output with a null, for better multiline support -
-r <REVERSE>,--reverse <REVERSE>: Default:true. -
--timezone <TIMEZONE>: Display the command time in another timezone other than the configured default.This option takes one of the following kinds of values:
- the special value “local” (or “l”) which refers to the system time zone
- a time zone name (e.g. “Europe/Berlin”)
- an offset from UTC (e.g. “+9”, “-2:30”)
-
-f <FORMAT>,--format <FORMAT>: Available variables: {command}, {directory}, {duration}, {user}, {host}, {author}, {intent}, {exit}, {time}, {session}, and {uuid}Example: —format “{time} - [{duration}] - {directory}$\t{command}”
atuin history last
Section titled “atuin history last”Get the last command that was run
atuin history last [OPTIONS]Options
Section titled “Options”-
--human -
--cmd-only: Show only the text of the command -
--timezone <TIMEZONE>: Display the command time in another timezone other than the configured default.This option takes one of the following kinds of values:
- the special value “local” (or “l”) which refers to the system time zone
- a time zone name (e.g. “Europe/Berlin”)
- an offset from UTC (e.g. “+9”, “-2:30”)
-
-f <FORMAT>,--format <FORMAT>: Available variables: {command}, {directory}, {duration}, {user}, {host}, {author}, {intent}, {time}, {session}, {uuid} and {relativetime}.Example: —format “{time} - [{duration}] - {directory}$\t{command}”
atuin history init-store
Section titled “atuin history init-store”atuin history init-storeatuin history prune
Section titled “atuin history prune”Delete history entries matching the configured exclusion filters
atuin history prune [OPTIONS]Options
Section titled “Options”-n,--dry-run: List matching history lines without performing the actual deletion
atuin history dedup
Section titled “atuin history dedup”Delete duplicate history entries (that have the same command, cwd and hostname)
atuin history dedup [OPTIONS] --before <BEFORE> --dupkeep <DUPKEEP>Options
Section titled “Options”-n,--dry-run: List matching history lines without performing the actual deletion-b <BEFORE>,--before <BEFORE>: Only delete results added before this date, read in the configured timezone unless it carries an explicit offset. Required.--dupkeep <DUPKEEP>: How many recent duplicates to keep. Required.