Atuin 解决什么问题
Atuin 将 Shell 历史存入本地 SQLite 数据库,并保留目录、退出状态等上下文。你可以跨终端会话搜索已有命令,减少反复回忆参数的时间。
先把本地搜索用起来,再决定是否需要跨机器同步。CLI 不依赖 Python,日常本地搜索也不需要注册账号或运行同步服务器。
安装 CLI 并接入 Zsh
macOS 使用 Homebrew 时可以执行:
brew install atuin
atuin --version
Linux、Windows 和其他包管理器请按官方安装文档选择对应方式。旧文中的 pip install atuin 不是这里介绍的 Atuin CLI 的安装方式。
Zsh 用户在 ~/.zshrc 中添加一次:
eval "$(atuin init zsh)"
打开新终端,再导入已有历史:
atuin import auto
atuin init 后的参数表示 Shell 类型。Bash、Fish、PowerShell 的接入方式不同,应按文档配置各自的启动文件。
配置文件使用 TOML
配置采用 TOML。当前文档的默认路径是 ~/.atuin/config.toml,旧安装可能继续使用 ~/.config/atuin/config.toml 或 XDG 路径。ATUIN_HOME、ATUIN_CONFIG_DIR 也会影响位置,修改前先核对当前安装。例如:
search_mode = "fuzzy"
filter_mode = "global"
修改后重新打开搜索界面检查效果。配置项以官方配置文档及安装版本为准;旧文中的 config.yaml 路径不适用于该配置。
搜索、检查,再复用命令
完成 Shell 集成后,按 Ctrl+R 打开交互搜索,输入记得的命令片段。执行前检查目录、主机、参数和环境,避免把历史中的生产操作带到错误的上下文。
也可以在命令行查看历史:
atuin history list
atuin search "git"
atuin search --help
如果 Ctrl+R 仍然是原来的搜索界面,检查初始化代码是否在交互 Shell 中执行,以及后加载的插件是否覆盖了快捷键。
用目录、会话和时间缩小范围
历史较多时,先通过交互界面的过滤模式缩小到相关目录、会话或主机。命令行搜索支持的目录、退出码和时间参数可通过 atuin search --help 确认,具体示例见搜索参考。
优先使用当前版本明确支持的搜索与过滤参数,不要把其他工具的标签、任务运行命令套到 Atuin 上。
日常使用价值
数据库让历史不再局限于一个终端会话;目录和主机上下文则帮助区分看起来相同的命令。搜索到的内容仍需要人工检查,尤其是包含密钥、生产地址或删除参数的命令。
历史记录说明某个命令曾经执行过,不代表现在适合再次执行。
跨机器同步是可选项
需要同步时,再按官方同步指南注册或登录,并配置第二台设备。妥善保存加密密钥,区分账号登录凭据与历史加密密钥的用途。
自建同步服务端是独立的部署工作,当前服务端安装指南使用 atuin-server 二进制。同步前检查历史排除规则,避免把不应保留的敏感命令写入历史。
建议的上手顺序
安装 CLI、接入实际使用的 Shell、导入历史,然后找回三条常用命令。确认本地体验满足需求后,再考虑同步和过滤设置。
命令与文档于 2026 年 10 月 16 日核对,项目实现见 Atuin 仓库。实际快捷键行为取决于安装版本和 Shell 配置。