Atuin：魔法般的 Shell 历史记录管理

项目简介

Atuin 用 SQLite 数据库替换你现有的 shell 历史记录，并为每条命令保存额外的上下文信息。它还提供可选的、完全加密的历史同步功能，让不同终端、不同会话、不同机器共享同一份历史。

同步可以选择使用官方托管的服务器，也可以自建，或者干脆不用同步。所有历史同步都是加密的，即使作者也无法读取你的数据。旧的历史文件不会被替换或删除。

主要功能

• 重新绑定 ctrl-r 和 up（可配置）到一个全屏历史搜索界面
• 将 shell 历史存储在 SQLite 数据库中
• 备份并同步加密的 shell 历史
• 同一份历史跨终端、跨会话、跨机器使用
• 记录退出码、工作目录、主机名、会话、命令耗时等信息
• 统计「最常用的命令」等数据
• 使用 <kbd>Alt-<num></kbd> 快速跳转到之前的条目
• 通过 ctrl-r 切换过滤模式：仅当前会话、当前目录或全局
• 回车执行命令，Tab 编辑命令

除了搜索界面，还可以做条件查询，例如查找昨天下午 3 点之后执行成功过的 make 命令：

atuin search --exit 0 --after "yesterday 3pm" make

安装与使用

快速上手脚本会为你注册 Atuin Cloud 同步服务器：

curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

atuin register -u <USERNAME> -e <EMAIL>
atuin import auto
atuin sync

之后重启 shell 即可。安装、离线配置、自建服务器、导入历史等更多内容见官方文档。

支持的 shell 包括 zsh、bash、fish、nushell、xonsh 和 PowerShell，完整的支持矩阵见文档。

Bash 用户注意：上面的脚本会为必要的钩子配置 bash-preexec，而 bash-preexec 存在一些限制，详情请参阅安装文档中的 Bash 章节。

注意事项

• 如果不想使用云端同步，可以参考文档进行离线配置或自建服务端。
• 项目采用 MIT 许可证。
• 遇到问题可以通过社区论坛、libera.chat 上的 #atuin 频道或 Discord 寻求帮助。

---

本作品整理自 GitHub 开源项目 atuinsh/atuin，原作者 @atuinsh，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。