Skip to content
Atuin

[ui]

The layout of interactive search.

The columns of interactive search, from left to right, after the selection marker. For example, ["exit", { type = "directory", width = 30 }, "command"].

A column is its type, or a table of its type, width and expand. At most one column may expand to fill the space left.

  • Type: list of string or table
  • Default: [{ type = "duration", width = 5, expand = false }, { type = "time", width = 9, expand = false }, { type = "command", width = 0, expand = true }]
  • Values:
    • duration: How long the command ran, such as 123ms. It is 5 wide by default.
    • time: How long ago the command ran, such as 59s ago. It is 9 wide by default.
    • datetime: When the command ran, such as 2025-01-22 14:35. It is 16 wide by default.
    • directory: The directory the command ran in. It is 20 wide by default.
    • host: The host the command ran on. It is 15 wide by default.
    • user: The user who ran the command. It is 10 wide by default.
    • exit: The command’s exit code. It is 3 wide by default, or 11 on Windows.
    • command: The command itself. It expands to fill the space left by default.

Highlight the syntax of commands in the results. The Syntax* keys of a theme set the colors.

Commands from shells without a grammar, such as nu, xonsh and PowerShell, aren’t highlighted.

  • Type: boolean
  • Default: true