$atuin doctor provides some useful info.
On my systems (Linux Mint Cinnamon (mine), Fedora and Ubuntu (work)) the config files are spread all over the place(s). My memory resembles Swiss cheese, so remembering their locations is a challenge.
if doctor also provided the location of the configs and the files it likes to modify to make it work, it may remove some load off the forums(?) by people like me ![]()
e.g. the AI when queried, dumped the following on this particular system (my dev box, one of β¦ uummm, four!)
Hereβs the full picture of Atuin on your system:
Binary
- /home/atomicrobot/.atuin/bin/atuin β installed via cargo-dist (v18.18.1)
Config files
- /home/atomicrobot/.config/atuin/config.toml β main config
- /home/atomicrobot/.config/atuin/permissions.ai.toml β AI permission grants
- /home/atomicrobot/.config/atuin/atuin-receipt.json β install receipt (metadata)
Data files
/home/atomicrobot/.local/share/atuin/ β all databases live here:
history.db β your command history
ai_sessions.db β AI session continuity
records.db, meta.db, kv.db, scripts.db β sync & internal state
key β encryption key
dotfiles/ β synced shell aliases
Logs
/home/atomicrobot/.atuin/logs/ β with the config we just added:
ai.log.YYYY-MM-DD β AI requests/responses (debug level)
daemon.log.YYYY-MM-DD β daemon logs
search.log.YYYY-MM-DD β search logs
Shell init (atuin lives in three shells)
- fish: ~/.config/fish/config.fish β atuin init fish | source
- bash: ~/.bashrc β sources env + atuin init bash
- zsh: ~/.zshrc β sources env + atuin init zsh
Env script
- /home/atomicrobot/.atuin/bin/env β shared env setup sourced by bash/zsh