config
atuin config
Section titled “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.
Subcommands
Section titled “Subcommands”atuin config get <key>
Section titled “atuin config get <key>”Print the value of a key as it appears in your config file.
$ atuin config get search_modefuzzy
$ atuin config get daemon[daemon]enabled = truesocket_path = "/tmp/atuin_daemon.sock"If the key isn’t present in the config file, you’ll see:
$ atuin config get enter_accept(not set in config file)--resolved / -r
Section titled “--resolved / -r”Print the effective value after merging defaults, the config file, and environment variable overrides:
$ atuin config get enter_accept --resolvedfalseThis also works for table keys, showing all resolved children as flat dotted key=value pairs:
$ atuin config get logs --resolvedlogs.ai.file = ai.loglogs.daemon.file = daemon.loglogs.dir = /home/user/.atuin/logslogs.enabled = truelogs.level = infologs.search.file = search.log--verbose / -v
Section titled “--verbose / -v”Show both the config file value and the resolved value side by side:
$ atuin config get enter_accept --verboseConfig file: (not set in config file)
Resolved: falseatuin config set <key> <value>
Section titled “atuin config set <key> <value>”Set a configuration value in your config.toml. The file’s existing
formatting and comments are preserved.1
$ atuin config set search_mode fuzzy$ atuin config set logs.level debugTo turn on the daemon, run atuin setup --only --daemon, which sets
daemon.autostart along with daemon.enabled. See
daemon.
Type detection
Section titled “Type detection”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 |
--type / -t
Section titled “--type / -t”Override type detection with an explicit type:
$ atuin config set sync_frequency 600 --type stringPossible 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:
$ atuin config set logs trueError: 'logs' is a table; use a dotted key like 'logs.key' to set a value within itatuin config check
Section titled “atuin config check”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.
atuin config print [key]
Section titled “atuin config print [key]”Print configuration values from your config file in TOML format. Without a key, prints the entire file. With a key, prints that section:
$ atuin config print daemon[daemon]enabled = truesocket_path = "/tmp/atuin_daemon.sock"pidfile_path = "/tmp/atuin_daemon.pid"autostart = falseFootnotes
Section titled “Footnotes”-
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. ↩