# 使用 Homebrew, MacPorts 安装 historian

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

## 安装

```sh
sudo av install brew:historian
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install historian
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install hist
```

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

## 软件包事实

- **软件包键:** brew:historian
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/historian>
- **版本:** 0.0.2
- **来源摘要:** Command-line utility for managing shell history in a SQLite database
- **主页:** <https://github.com/jcsalterego/historian>
- **仓库:** <https://github.com/jcsalterego/historian>
- **上游文档:** <https://github.com/jcsalterego/historian#readme>
- **许可证:** BSD-2-Clause
- **源码归档:** <https://github.com/jcsalterego/historian/archive/refs/tags/0.0.2.tar.gz>
- **已生成:** 2026-07-08T07:18:31+00:00

## 可执行文件

- hist (cli)
- hist (别名)

## macOS 提供的库

- sqlite

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 all

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.0.2
- 本地数据: OK
- 上游仓库: https://github.com/jcsalterego/historian
- 检测到的最新版本: 0.0.2 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

historian is a small shell-history utility that imports `~/.bash_history` into SQLite and exposes a `hist` command for config, import, search, and log viewing. It is a niche predecessor to later shell-history database tools.

### 项目历史

The repository begins on 2017-04-10 with an initial commit. Tags 0.0.1 and 0.0.2 followed within days, and the README documents the utility as a command-line manager for shell history in a SQLite database.

The project is intentionally narrow: dedupe and import Bash history, store it in `~/.historian.db`, search it, and optionally run `hist import` from a shell profile.

### 采用历史

Official adoption evidence is thin. Homebrew and MacPorts package records in the batch input indicate that the tool crossed from a personal script-style repository into package-manager distribution, but the official README does not describe a wider community.

### 使用方式

A user places the script directory on PATH or aliases `hist`, runs `hist import`, and searches with `hist search term` or shorthand `hist /term`. `hist config` prints paths for Bash history, the SQLite database, and sqlite3.

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

historian is package-nerd-interesting mainly because it captures the minimal SQLite shell-history idea in a tiny package: no daemon, no sync, no terminal UI, just import and query. That simplicity makes it a useful contrast with later tools such as hiSHtory and Atuin.

### 时间线

- 2017-04-10: Initial commit.
- 2017-04-11: 0.0.1 is tagged.
- 2017-04-14: 0.0.2 is tagged.
- 2017: README documents import, config, search, and log workflows.

### Related projects

- hiSHtory and Atuin are later, larger shell-history tools with contextual search and sync.
- SQLite is the core storage dependency documented by historian.

### 来源

- Official Git repository tags and commits for timeline dates.
- Official README for feature scope, install, usage, and database paths.


## 安全说明

broad file, network, media, or database tool signal. generalized runtime or code generation signal.

- **Geiger 风险:** yellow / 中
- broad file, network, media, or database tool signal
- generalized runtime or code generation signal

## 源数据库详情

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

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

- MacPorts - hist: installed executable or alias match | MacPorts ports tree: math/hist/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [hishtory](https://www.automicvault.com/zh-hans/pkg/brew/hishtory/) - Shares av.db curated category or tags: cli, developer-tools, history, shell, shell-history.
- [aliae](https://www.automicvault.com/zh-hans/pkg/brew/aliae/) - 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.
- [bashate](https://www.automicvault.com/zh-hans/pkg/brew/bashate/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [checkbashisms](https://www.automicvault.com/zh-hans/pkg/brew/checkbashisms/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [desk](https://www.automicvault.com/zh-hans/pkg/brew/desk/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [fish](https://www.automicvault.com/zh-hans/pkg/brew/fish/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [fish-lsp](https://www.automicvault.com/zh-hans/pkg/brew/fish-lsp/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [powershell](https://www.automicvault.com/zh-hans/pkg/brew/powershell/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line.
- [sqlx-cli](https://www.automicvault.com/zh-hans/pkg/brew/sqlx-cli/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, command-line, database, developer, developer-tools.

## Combined YAML source

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


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
