atuin

Atuin Shell 历史管理

补充说明

atuin 把 shell 历史存入 SQLite，支持模糊搜索、统计和跨机器加密同步。它通过 shell hook 记录命令和上下文。

常用示例

atuin init zsh
atuin init bash
atuin init fish
atuin search 'docker'
atuin search --limit 20 'git rebase'
atuin stats
atuin login
atuin sync
atuin register
atuin config

~/.config/atuin/config.toml：

auto_sync = true
update_check = false
search_mode = "fuzzy"
filter_mode = "global"

易错点与排错

• 必须在 shell 配置中 eval "$(atuin init zsh)"，否则不会记录/搜索。
• 同步是端到端加密；加密密钥丢失后无法解密远端历史。
• 历史可能包含敏感信息（token、密码）；同步前评估隐私。
• 首次导入旧历史要用 atuin import auto，并确认 shell 类型。
• auto_sync 失败通常是网络或登录状态；看 atuin status。
• 自托管服务要配置 sync_address，并确认 TLS/认证。
• 多机器同步冲突会合并，但命令顺序不保证完全一致。

相关命令

• history — Shell 内置历史
• fzf — 模糊搜索
• zsh / fish — Shell 集成