Skip to content
Atuin

config

Read, write, and inspect Atuin configuration values. Atuin resolves configuration from multiple sources (defaults, config file, environment variables). The config command lets you see what’s set where, and change values in your config.toml without opening an editor.

Print the value of a key as it appears in your config file.

Terminal window
$ atuin config get search_mode
fuzzy
$ atuin config get daemon
[daemon]
enabled = true
socket_path = "/tmp/atuin_daemon.sock"

If the key isn’t present in the config file, you’ll see:

Terminal window
$ atuin config get enter_accept
(not set in config file)

Print the effective value after merging defaults, the config file, and environment variable overrides:

Terminal window
$ atuin config get enter_accept --resolved
false

This also works for table keys, showing all resolved children as flat dotted key=value pairs:

Terminal window
$ atuin config get logs --resolved
logs.ai.file = ai.log
logs.daemon.file = daemon.log
logs.dir = /home/user/.atuin/logs
logs.enabled = true
logs.level = info
logs.search.file = search.log

Show both the config file value and the resolved value side by side:

Terminal window
$ atuin config get enter_accept --verbose
Config file:
(not set in config file)
Resolved:
false

Set a configuration value in your config.toml. The file’s existing formatting and comments are preserved.1

Terminal window
$ atuin config set search_mode fuzzy
$ atuin config set logs.level debug

To turn on the daemon, run atuin setup --only --daemon, which sets daemon.autostart along with daemon.enabled. See daemon.

By default, set matches the TOML type of the existing value when the key is already in the config file. This prevents accidentally changing a string like "300" into an integer 300.

For new keys (not already in the file), set automatically detects the type:

Value Detected type
true/false boolean
42, -1 integer
3.14 float
anything else string

Override type detection with an explicit type:

Terminal window
$ atuin config set sync_frequency 600 --type string

Possible values: auto, string, boolean, integer, float.

Setting a key that’s currently a table will produce an error directing you to use a dotted key instead:

Terminal window
$ atuin config set logs true
Error: 'logs' is a table; use a dotted key like 'logs.key' to set a value within it

Atuin ignores keys and tables in config.toml that it doesn’t recognize. To check if your configuration contains any such items, run atuin config check.

Print configuration values from your config file in TOML format. Without a key, prints the entire file. With a key, prints that section:

Terminal window
$ atuin config print daemon
[daemon]
enabled = true
socket_path = "/tmp/atuin_daemon.sock"
pidfile_path = "/tmp/atuin_daemon.pid"
autostart = false
  1. If your config doesn’t already contain the key, Atuin searches for an intelligent place to insert it. If your config has a commented-out assignment of the key like # style = "compact", Atuin may uncomment the example and update the value, or insert a new assignment nearby, depending on whether it’s safe to replace the comment. ↩