# 使用 Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper 安装 atuin

查看 atuin 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:atuin
```

## 代理安全回答

atuin stores and syncs shell history, which may include sensitive commands.

- **凭据访问:** Reads shell history, sync tokens, and command text that may contain secrets.
- **远程变更:** Can sync history to remote storage and change account state.
- **发布/制品风险:** Can publish sensitive command history to a sync backend.
- **推荐控制:** Gate sync, import, and commands that expose stored history.
- **代理使用指南:** Allow local search cautiously; require approval before sync or history export.

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install atuin
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install atuin
```

  证据: MacPorts ports tree: sysutils/atuin/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add atuin
```

  证据: Alpine Linux edge package indexes: atuin from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install atuin
```

  证据: Debian stable package indexes: atuin from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install atuin
```

  证据: Fedora Rawhide package metadata: atuin from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#atuin
```

  证据: nixpkgs package indexes: pkgs/by-name/at/atuin/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S atuin
```

  证据: Arch Linux sync databases: atuin from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install atuin
```

  证据: openSUSE Tumbleweed package metadata: atuin from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/atuin
```

  证据: Scoop official bucket manifest trees: bucket/atuin.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Atuinsh.Atuin -e
```

  证据: Windows Package Manager source index: Atuinsh.Atuin from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:atuin
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/atuin>
- **版本:** 18.16.1
- **来源摘要:** Improved shell history for zsh, bash, fish and nushell
- **主页:** <https://atuin.sh/>
- **仓库:** <https://github.com/atuinsh/atuin>
- **上游文档:** <https://docs.atuin.sh>
- **许可证:** MIT
- **源码归档:** <https://github.com/atuinsh/atuin/releases/download/v18.16.1/source.tar.gz>
- **最后更新:** 2026-05-22T13:25:38Z
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- atuin (cli)
- atuin (别名)

## 构建依赖

- protobuf
- rust

## 安装行为

- post-install 钩子: 未定义
- 服务: declared
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 18.16.1
- 管理器更新时间: 2026-05-22
- 本地数据: OK
- 上游仓库: https://github.com/atuinsh/atuin
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

Atuin is a shell-history replacement that records commands in a local SQLite database, adds command context such as exit status and duration, and optionally syncs encrypted history between machines. It is popular with terminal-heavy users because it modernizes one of the oldest Unix workflows without forcing a specific shell.

### 项目历史

The Atuin GitHub repository was created in October 2020. The README frames the project as replacing existing shell history with a SQLite database and adding contextual metadata, search UI, statistics, and optional encrypted synchronization through an Atuin server.

Atuin's early public release history in the GitHub releases API reaches at least the 0.6 series in 2021, with later version lines moving through v11 in 2022, v17 in 2023, and v18 in 2024. By the 18.x series, the project had a large release surface: prebuilt binaries, installers, shell integrations, a self-hosted server binary, documentation, and continuing changes to search, sync, daemon, and AI-related terminal workflows.

The project kept the local-first model central while expanding the surrounding system. Configuration docs still describe `~/.config/atuin/config.toml` and `~/.local/share/atuin`, while the sync guide documents registering, storing a local encryption key, and using manual or automatic sync.

### 采用历史

Atuin's adoption path followed shell users rather than service operators first. The README lists zsh, bash, fish, nushell, xonsh, and PowerShell support, and the quickstart flow is a shell install, `atuin register`, `atuin import auto`, and `atuin sync`.

The package-manager metadata in this batch shows wide packaging across Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Scoop, WinGet, and openSUSE. That spread is a strong package-culture signal: Atuin is not only a Cargo crate or GitHub binary, but a tool distributions expect terminal users to install through their normal system package channels.

The README also advertises community channels and a contributor graph, while the GitHub API showed roughly thirty thousand stars during this run. Those are not functional requirements, but they explain why shell-history nerds recognize Atuin as part of the modern Rust CLI wave alongside tools that replace long-lived Unix defaults with richer local databases and fuzzy interfaces.

### 使用方式

Atuin's everyday usage is interactive: bind Ctrl-R or the up arrow to its full-screen history search, import old shell history, and search across commands with filters for exit status, time, current directory, session, host, or workspace. The README example searches successful `make` commands run after a natural-language time expression.

The configuration docs state that Atuin stores config in `~/.config/atuin/config.toml`, data under `~/.local/share/atuin` unless XDG variables override it, and defaults the local history database to `~/.local/share/atuin/history.db`. The same docs identify the encryption key and session-token paths, which is why package databases should treat those files as credentials rather than mere cache.

Sync is optional. With one machine it behaves like an encrypted backup; with multiple machines it unifies history across terminals and hosts. Users can use the hosted Atuin service, self-host `atuin-server`, or skip sync entirely.

### 为什么软件包爱好者会关心

Atuin is package-nerd catnip because it turns a humble dotfile-era feature into a cross-shell, cross-platform database-backed CLI with state, sync, packaging splits, and XDG-path behavior. Formula metadata has to know not just the executable name, but also the data files that become personal secrets.

It also illustrates the Rust CLI packaging pattern: upstream publishes release artifacts and installers, but downstream package managers carry the tool for users who want normal upgrades and shell integration without a curl pipe. The separate `atuin-server` formula adds another wrinkle because the same repository produces both a daily interactive CLI and a deployable sync service.

### 时间线

- 2020: Atuin repository created on GitHub.
- 2021: Early 0.6 and 0.7 releases published.
- 2022: v0.10 shipped and the project later jumped to v11.
- 2023: v17 release line published.
- 2024: v18 release line began.
- 2026: v18.16.x releases included continued shell, sync, server, and AI workflow changes.

### Related projects

- atuin-server: the self-hosted sync server split into its own installable binary.
- SQLite: Atuin's default local history database.
- fzf-style fuzzy search: the documented inspiration for Atuin fuzzy search syntax.
- Native shell history in zsh, bash, fish, nushell, xonsh, and PowerShell: the behavior Atuin augments or replaces.

### 来源

- <https://api.github.com/repos/atuinsh/atuin>
- <https://api.github.com/repos/atuinsh/atuin/releases>
- <https://docs.atuin.sh/cli/configuration/config/>
- <https://docs.atuin.sh/cli/guide/sync/>
- <https://github.com/atuinsh/atuin#readme>


## 安全说明

formula declares a Homebrew service. generalized runtime or code generation signal.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service
- generalized runtime or code generation signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/atuin/config.toml, ~/.config/atuin/config.toml

## Credential files

- Unix: $XDG_DATA_HOME/atuin/key, $XDG_DATA_HOME/atuin/session, ~/.local/share/atuin/key, ~/.local/share/atuin/session
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** atuin
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 其他软件包管理器记录

- Debian apt - atuin - 18.6.1-1: normalized package name match | Debian stable package indexes: atuin from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | magical shell history | https://atuin.sh
- Nix - atuin: normalized package name match | nixpkgs package indexes: pkgs/by-name/at/atuin/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - atuin - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Magical shell history - offline only client | https://github.com/atuinsh/atuin
- apk - atuin-bash-completion - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for atuin | https://github.com/atuinsh/atuin
- apk - atuin-fish-completion - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for atuin | https://github.com/atuinsh/atuin
- apk - atuin-server - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-server from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Magical shell history - sync server | https://github.com/atuinsh/atuin
- apk - atuin-server-openrc - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-server-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Magical shell history (OpenRC init scripts) | https://github.com/atuinsh/atuin
- apk - atuin-sync - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-sync from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Magical shell history - client with history sync | https://github.com/atuinsh/atuin
- apk - atuin-zsh-completion - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for atuin | https://github.com/atuinsh/atuin
- apk - atuin-zsh-plugin - 18.6.1-r0: normalized package name match | Alpine Linux edge package indexes: atuin-zsh-plugin from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Magical shell history (Zsh plugin) | https://github.com/atuinsh/atuin
- dnf - atuin - 18.12.1-1.fc45: normalized package name match | Fedora Rawhide package metadata: atuin from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Magical shell history | https://atuin.sh
- dnf - atuin-all-users - 18.12.1-1.fc45: normalized package name match | Fedora Rawhide package metadata: atuin-all-users from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | atuin init script for all users | https://atuin.sh
- pacman - atuin - 18.16.1-1: normalized package name match | Arch Linux sync databases: atuin from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Magical shell history | https://github.com/atuinsh/atuin
- zypper - atuin - 18.16.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: atuin from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Magical shell history | https://github.com/ellie/atuin
- zypper - atuin-bash-completion - 18.16.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: atuin-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash completion for atuin | https://github.com/ellie/atuin
- zypper - atuin-fish-completion - 18.16.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: atuin-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish completion for atuin | https://github.com/ellie/atuin


## 相关链接

- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [protobuf](https://www.automicvault.com/zh-hans/pkg/brew/protobuf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [atuin-server](https://www.automicvault.com/zh-hans/pkg/brew/atuin-server/) - Shares the same upstream source repository.
- [mcfly](https://www.automicvault.com/zh-hans/pkg/brew/mcfly/) - Shares av.db curated category or tags: cli, developer-tools, history, shell.
- [aliae](https://www.automicvault.com/zh-hans/pkg/brew/aliae/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [argc](https://www.automicvault.com/zh-hans/pkg/brew/argc/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [babelfish](https://www.automicvault.com/zh-hans/pkg/brew/babelfish/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bar](https://www.automicvault.com/zh-hans/pkg/brew/bar/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bash-language-server](https://www.automicvault.com/zh-hans/pkg/brew/bash-language-server/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bashdb](https://www.automicvault.com/zh-hans/pkg/brew/bashdb/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [fizsh](https://www.automicvault.com/zh-hans/pkg/brew/fizsh/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, fish, history.

## Combined YAML source

View the package source record on GitHub. [combined/atuin.yml](https://github.com/automic-vault/db/blob/main/combined/atuin.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
