Skip to content

Instantly share code, notes, and snippets.

@mike-anderson
Last active March 17, 2026 18:32
Show Gist options
  • Select an option

  • Save mike-anderson/f00d091974bdd3bd27b97903a96dbafd to your computer and use it in GitHub Desktop.

Select an option

Save mike-anderson/f00d091974bdd3bd27b97903a96dbafd to your computer and use it in GitHub Desktop.

Revisions

  1. mike-anderson revised this gist Mar 17, 2026. 1 changed file with 2 additions and 2 deletions.
    4 changes: 2 additions & 2 deletions config.toml
    Original file line number Diff line number Diff line change
    @@ -312,11 +312,11 @@ enabled = true

    ## Width of the tmux popup window
    ## Can be a percentage, or integer (e.g. "100" means 100 characters wide)
    # width = "80%"
    width = "60%"

    ## Height of the tmux popup window
    ## Can be a percentage, or integer (e.g. "100" means 100 lines tall)
    # height = "60%"
    height = "16"

    [ui]
    ## Columns to display in the interactive search, from left to right.
  2. mike-anderson revised this gist Mar 17, 2026. No changes.
  3. mike-anderson revised this gist Mar 17, 2026. 1 changed file with 7 additions and 7 deletions.
    14 changes: 7 additions & 7 deletions config.toml
    Original file line number Diff line number Diff line change
    @@ -44,7 +44,7 @@ sync_address = ""

    ## which search mode to use
    ## possible values: prefix, fulltext, fuzzy, skim
    search_mode = "fuzzy"
    # search_mode = "fuzzy"

    ## which filter mode to use by default
    ## possible values: "global", "host", "session", "session-preload", "directory", "workspace"
    @@ -71,7 +71,7 @@ workspaces = true

    ## which style to use
    ## possible values: auto, full, compact
    style = "compact"
    style = "full"

    ## the maximum number of lines the interface should take up
    ## set it to 0 to always go full screen
    @@ -87,7 +87,7 @@ inline_height_shell_up_key_binding = 14

    ## enable or disable showing a preview of the selected command
    ## useful when the command is longer than the terminal width and is cut off
    # show_preview = true
    show_preview = false

    ## what to do when the escape key is pressed when searching
    ## possible values: return-original, return-query
    @@ -140,10 +140,10 @@ inline_height_shell_up_key_binding = 14
    ## Configure whether or not to show the help row, which includes the current Atuin
    ## version (and whether an update is available), a keymap hint, and the total
    ## amount of commands in your history.
    # show_help = true
    show_help = false

    ## Configure whether or not to show tabs for search and inspect
    # show_tabs = true
    show_tabs = false

    ## Configure whether or not the tabs row may be auto-hidden, which includes the current Atuin
    ## tab, such as Search or Inspector, and other tabs you may wish to see. This will
    @@ -262,7 +262,7 @@ records = true

    [daemon]
    ## Enables using the daemon to sync. Requires the daemon to be running in the background. Start it with `atuin daemon`
    # enabled = false
    enabled = false

    ## How often the daemon should sync in seconds
    # sync_frequency = 300
    @@ -340,7 +340,7 @@ enabled = true
    ## column fill remaining space. Only one column should have expand = true.
    ##
    ## Default:
    # columns = ["duration", "time", "command"]
    columns = ["time", "command"]
    ##
    ## Examples:
    ##
  4. mike-anderson renamed this gist Mar 15, 2026. 1 changed file with 0 additions and 0 deletions.
    File renamed without changes.
  5. mike-anderson renamed this gist Mar 15, 2026. 1 changed file with 0 additions and 0 deletions.
    File renamed without changes.
  6. mike-anderson revised this gist Mar 15, 2026. No changes.
  7. mike-anderson revised this gist Mar 15, 2026. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion README.md
    Original file line number Diff line number Diff line change
    @@ -15,4 +15,4 @@ Modify `~/.zshrc`
    plugins=(zsh-autosuggestions zsh-syntax-highlighting git 1password aws brew docker encode64 gh nvm uv)
    ```

    Modify `~/.config/atuin/config.toml` with the file above (turns off sync and sets up arrow suggestions to compact
    Modify `~/.config/atuin/config.toml` with the `config.toml` included (turns off sync and sets up arrow suggestions to compact
  8. mike-anderson created this gist Mar 15, 2026.
    18 changes: 18 additions & 0 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,18 @@

    ```
    brew install ghostty atuin
    #install ohmyzsh
    sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
    #install ohmyzsh autocompletion extensions
    git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
    git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
    ```

    Modify `~/.zshrc`
    ```
    plugins=(zsh-autosuggestions zsh-syntax-highlighting git 1password aws brew docker encode64 gh nvm uv)
    ```

    Modify `~/.config/atuin/config.toml` with the file above (turns off sync and sets up arrow suggestions to compact
    360 changes: 360 additions & 0 deletions config.toml
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,360 @@
    ## Base directory for Atuin data files (databases, keys, session, etc.)
    ## All data file paths default to being relative to this directory.
    ## linux/mac: ~/.local/share/atuin (or XDG_DATA_HOME/atuin)
    ## windows: %USERPROFILE%/.local/share/atuin
    # data_dir = "~/.local/share/atuin"

    ## where to store your database, default is your system data directory
    ## linux/mac: ~/.local/share/atuin/history.db
    ## windows: %USERPROFILE%/.local/share/atuin/history.db
    # db_path = "~/.history.db"

    ## where to store your encryption key, default is your system data directory
    ## linux/mac: ~/.local/share/atuin/key
    ## windows: %USERPROFILE%/.local/share/atuin/key
    # key_path = "~/.key"

    ## where to store your auth session token, default is your system data directory
    ## linux/mac: ~/.local/share/atuin/session
    ## windows: %USERPROFILE%/.local/share/atuin/session
    # session_path = "~/.session"

    ## date format used, either "us" or "uk"
    # dialect = "us"

    ## default timezone to use when displaying time
    ## either "l", "local" to use the system's current local timezone, or an offset
    ## from UTC in the format of "<+|->H[H][:M[M][:S[S]]]"
    ## for example: "+9", "-05", "+03:30", "-01:23:45", etc.
    # timezone = "local"

    ## enable or disable automatic sync
    auto_sync = false

    ## enable or disable automatic update checks
    # update_check = true

    ## address of the sync server
    sync_address = ""

    ## how often to sync history. note that this is only triggered when a command
    ## is ran, so sync intervals may well be longer
    ## set it to 0 to sync after every command
    # sync_frequency = "10m"

    ## which search mode to use
    ## possible values: prefix, fulltext, fuzzy, skim
    search_mode = "fuzzy"

    ## which filter mode to use by default
    ## possible values: "global", "host", "session", "session-preload", "directory", "workspace"
    ## consider using search.filters to customize the enablement and order of filter modes
    # filter_mode = "global"

    ## With workspace filtering enabled, Atuin will filter for commands executed
    ## in any directory within a git repository tree (default: false).
    ##
    ## To use workspace mode by default when available, set this to true and
    ## set filter_mode to "workspace" or leave it unspecified and
    ## set search.filters to include "workspace" before other filter modes.
    workspaces = true

    ## which filter mode to use when atuin is invoked from a shell up-key binding
    ## the accepted values are identical to those of "filter_mode"
    ## leave unspecified to use same mode set in "filter_mode"
    # filter_mode_shell_up_key_binding = "global"

    ## which search mode to use when atuin is invoked from a shell up-key binding
    ## the accepted values are identical to those of "search_mode"
    ## leave unspecified to use same mode set in "search_mode"
    # search_mode_shell_up_key_binding = "fuzzy"

    ## which style to use
    ## possible values: auto, full, compact
    style = "compact"

    ## the maximum number of lines the interface should take up
    ## set it to 0 to always go full screen
    # inline_height = 0

    ## the maximum number of lines the interface should take up
    ## when atuin is invoked from a shell up-key binding
    ## the accepted values are identical to those of "inline_height"
    inline_height_shell_up_key_binding = 14

    ## Invert the UI - put the search bar at the top , Default to `false`
    # invert = false

    ## enable or disable showing a preview of the selected command
    ## useful when the command is longer than the terminal width and is cut off
    # show_preview = true

    ## what to do when the escape key is pressed when searching
    ## possible values: return-original, return-query
    # exit_mode = "return-original"

    ## possible values: emacs, subl
    # word_jump_mode = "emacs"

    ## characters that count as a part of a word
    # word_chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

    ## number of context lines to show when scrolling by pages
    # scroll_context_lines = 1

    ## use ctrl instead of alt as the shortcut modifier key for numerical UI shortcuts
    ## alt-0 .. alt-9
    # ctrl_n_shortcuts = true

    ## Show numeric shortcuts (1..9) beside list items in the TUI
    ## set to false to hide the moving numbers if you find them distracting
    # show_numeric_shortcuts = true

    ## default history list format - can also be specified with the --format arg
    # history_format = "{time}\t{command}\t{duration}"

    ## prevent commands matching any of these regexes from being written to history.
    ## Note that these regular expressions are unanchored, i.e. if they don't start
    ## with ^ or end with $, they'll match anywhere in the command.
    ## For details on the supported regular expression syntax, see
    ## https://docs.rs/regex/latest/regex/#syntax
    # history_filter = [
    # "^secret-cmd",
    # "^innocuous-cmd .*--secret=.+",
    # ]

    ## prevent commands run with cwd matching any of these regexes from being written
    ## to history. Note that these regular expressions are unanchored, i.e. if they don't
    ## start with ^ or end with $, they'll match anywhere in CWD.
    ## For details on the supported regular expression syntax, see
    ## https://docs.rs/regex/latest/regex/#syntax
    # cwd_filter = [
    # "^/very/secret/area",
    # ]

    ## Configure the maximum height of the preview to show.
    ## Useful when you have long scripts in your history that you want to distinguish
    ## by more than the first few lines.
    # max_preview_height = 4

    ## Configure whether or not to show the help row, which includes the current Atuin
    ## version (and whether an update is available), a keymap hint, and the total
    ## amount of commands in your history.
    # show_help = true

    ## Configure whether or not to show tabs for search and inspect
    # show_tabs = true

    ## Configure whether or not the tabs row may be auto-hidden, which includes the current Atuin
    ## tab, such as Search or Inspector, and other tabs you may wish to see. This will
    ## only be hidden if there are fewer than this count of lines available, and does not affect the use
    ## of keyboard shortcuts to switch tab. 0 to never auto-hide, default is 8 (lines).
    ## This is ignored except in `compact` mode.
    # auto_hide_height = 8

    ## Defaults to true. This matches history against a set of default regex, and will not save it if we get a match. Defaults include
    ## 1. AWS key id
    ## 2. Github pat (old and new)
    ## 3. Slack oauth tokens (bot, user)
    ## 4. Slack webhooks
    ## 5. Stripe live/test keys
    # secrets_filter = true

    ## Defaults to true. If enabled, upon hitting enter Atuin will immediately execute the command,
    ## whereas tab will put the command in the prompt for editing.
    ## If set to false, both enter and tab will place the command in the prompt for editing.
    ## This applies for new installs. Old installs will keep the old behaviour unless configured otherwise.
    enter_accept = true

    ## Defaults to false. If enabled, when triggered after &&, || or |, Atuin will complete commands to chain rather than replace the current line.
    # command_chaining = false

    ## Defaults to "emacs". This specifies the keymap on the startup of `atuin
    ## search`. If this is set to "auto", the startup keymap mode in the Atuin
    ## search is automatically selected based on the shell's keymap where the
    ## keybinding is defined. If this is set to "emacs", "vim-insert", or
    ## "vim-normal", the startup keymap mode in the Atuin search is forced to be
    ## the specified one.
    # keymap_mode = "auto"

    ## Cursor style in each keymap mode. If specified, the cursor style is changed
    ## in entering the cursor shape. Available values are "default" and
    ## "{blink,steady}-{block,underline,bar}".
    # keymap_cursor = { emacs = "blink-block", vim_insert = "blink-block", vim_normal = "steady-block" }

    # network_connect_timeout = 5
    # network_timeout = 5

    ## Timeout (in seconds) for acquiring a local database connection (sqlite)
    # local_timeout = 5

    ## Set this to true and Atuin will minimize motion in the UI - timers will not update live, etc.
    ## Alternatively, set env NO_MOTION=true
    # prefers_reduced_motion = false

    [stats]
    ## Set commands where we should consider the subcommand for statistics. Eg, kubectl get vs just kubectl
    # common_subcommands = [
    # "apt",
    # "cargo",
    # "composer",
    # "dnf",
    # "docker",
    # "dotnet",
    # "git",
    # "go",
    # "ip",
    # "jj",
    # "kubectl",
    # "nix",
    # "nmcli",
    # "npm",
    # "pecl",
    # "pnpm",
    # "podman",
    # "port",
    # "systemctl",
    # "tmux",
    # "yarn",
    # ]

    ## Set commands that should be totally stripped and ignored from stats
    # common_prefix = ["sudo"]

    ## Set commands that will be completely ignored from stats
    ignored_commands = [
    "cd",
    "ls",
    "ll",
    "la",
    "vi"
    ]

    [keys]
    # Defaults to true. If disabled, using the up/down key won't exit the TUI when scrolled past the first/last entry.
    # scroll_exits = true

    # Defaults to true. The left arrow key will exit the TUI when scrolling before the first character
    # exit_past_line_start = true

    # Defaults to true. The right arrow key performs the same functionality as Tab and copies the selected line to the command line to be modified.
    # accept_past_line_end = true

    # Defaults to false. The left arrow key performs the same functionality as Tab and copies the selected line to the command line to be modified.
    # accept_past_line_start = false

    # Defaults to false. The backspace key performs the same functionality as Tab and copies the selected line to the command line to be modified when at the start of the line.
    # accept_with_backspace = false

    [sync]
    # Enable sync v2 by default
    # This ensures that sync v2 is enabled for new installs only
    # In a later release it will become the default across the board
    records = true

    [preview]
    ## which preview strategy to use to calculate the preview height (respects max_preview_height).
    ## possible values: auto, static
    ## auto: length of the selected command.
    ## static: length of the longest command stored in the history.
    ## fixed: use max_preview_height as fixed height.
    # strategy = "auto"

    [daemon]
    ## Enables using the daemon to sync. Requires the daemon to be running in the background. Start it with `atuin daemon`
    # enabled = false

    ## How often the daemon should sync in seconds
    # sync_frequency = 300

    ## The path to the unix socket used by the daemon (on unix systems)
    ## linux/mac: ~/.local/share/atuin/atuin.sock
    ## windows: Not Supported
    # socket_path = "~/.local/share/atuin/atuin.sock"

    ## Use systemd socket activation rather than opening the given path (the path must still be correct for the client)
    ## linux: false
    ## mac/windows: Not Supported
    # systemd_socket = false

    ## The port that should be used for TCP on non unix systems
    # tcp_port = 8889

    # [theme]
    ## Color theme to use for rendering in the terminal.
    ## There are some built-in themes, including the base theme ("default"),
    ## "autumn" and "marine". You can add your own themes to the "./themes" subdirectory of your
    ## Atuin config (or ATUIN_THEME_DIR, if provided) as TOML files whose keys should be one or
    ## more of AlertInfo, AlertWarn, AlertError, Annotation, Base, Guidance, Important, and
    ## the string values as lowercase entries from this list:
    ## https://ogeon.github.io/docs/palette/master/palette/named/index.html
    ## If you provide a custom theme file, it should be called "NAME.toml" and the theme below
    ## should be the stem, i.e. `theme = "NAME"` for your chosen NAME.
    # name = "autumn"

    ## Whether the theme manager should output normal or extra information to help fix themes.
    ## Boolean, true or false. If unset, left up to the theme manager.
    # debug = true

    [search]
    ## The list of enabled filter modes, in order of priority.
    ## The "workspace" mode is skipped when not in a workspace or workspaces = false.
    ## Default filter mode can be overridden with the filter_mode setting.
    filters = [ "workspace", "global", "session", "directory" ]

    [tmux]
    ## Enable using atuin with tmux popup (requires tmux >= 3.2)
    ## When enabled and running inside tmux, Atuin will use a popup window for interactive search.
    ## Set to false to disable the popup.
    ## This can also be controlled with the ATUIN_TMUX_POPUP environment variable.
    ## Note: The tmux popup is currently supported in zsh, bash, and fish shells. This currently doesn't work with iTerm native tmux integration.
    enabled = true

    ## Width of the tmux popup window
    ## Can be a percentage, or integer (e.g. "100" means 100 characters wide)
    # width = "80%"

    ## Height of the tmux popup window
    ## Can be a percentage, or integer (e.g. "100" means 100 lines tall)
    # height = "60%"

    [ui]
    ## Columns to display in the interactive search, from left to right.
    ## The selection indicator (" > ") is always shown first implicitly.
    ##
    ## Each column can be specified as a simple string (uses default width)
    ## or as an object with type, width, and expand:
    ## { type = "directory", width = 30, expand = true }
    ##
    ## Available column types (with default widths):
    ## duration (5) - Command execution duration (e.g., "123ms")
    ## time (8) - Relative time since execution (e.g., "59m ago")
    ## datetime (16) - Absolute timestamp (e.g., "2025-01-22 14:35")
    ## directory (20) - Working directory (truncated if too long)
    ## host (15) - Hostname where command was run
    ## user (10) - Username
    ## exit (3) - Exit code (colored by success/failure)
    ## command (*) - The command itself (expands by default)
    ##
    ## The "expand" option (default: true for command, false for others) makes a
    ## column fill remaining space. Only one column should have expand = true.
    ##
    ## Default:
    # columns = ["duration", "time", "command"]
    ##
    ## Examples:
    ##
    ## Minimal - more space for commands:
    # columns = ["duration", "command"]
    ##
    ## With wider directory column:
    # columns = ["duration", { type = "directory", width = 30 }, "command"]
    ##
    ## Show host for multi-machine sync users:
    # columns = ["duration", "time", "host", "command"]
    ##
    ## Show exit codes prominently:
    # columns = ["exit", "duration", "command"]
    ##
    ## Make directory expand instead of command:
    # columns = ["duration", "time", { type = "directory", expand = true }, { type = "command", expand = false }]