# 使用 Homebrew, Nix 安装 framework-tool-tui

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

## 安装

```sh
sudo av install brew:framework-tool-tui
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install framework-tool-tui
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#framework-tool-tui
```

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

## 软件包事实

- **软件包键:** brew:framework-tool-tui
- **软件包管理器:** Homebrew
- **版本:** 0.8.5
- **来源摘要:** TUI for controlling and monitoring Framework Computers hardware
- **主页:** <https://github.com/grouzen/framework-tool-tui>
- **仓库:** <https://github.com/grouzen/framework-tool-tui>
- **最后更新:** 2026-08-02T20:58:34Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- framework-tool-tui (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.8.5
## 项目历史与用法

Framework System TUI is a Rust terminal dashboard for controlling and monitoring Framework laptop hardware. It exposes battery and charge controls, privacy toggles, keyboard and fingerprint brightness, USB-C PD port information, fan RPM, and BIOS/system information through a TUI.

### 项目历史

The GitHub repository was created in August 2025 and the first release, v0.1.0, followed the next day with BIOS display, overview information, README updates, cleanup, and GitHub Actions CI. The project is built with ratatui and crossterm, and its hardware layer uses FrameworkComputer's framework_lib crate.

Subsequent early releases added charge-limit control, brightness controls, PD port panels, fan speed information, layout and theme work, screenshots, and a GIF demo. By 2026 the release notes show work on Windows builds, crates.io publishing, official NixOS and Gentoo install instructions, and routine dependency maintenance.

### 采用历史

The README documents distribution through GitHub release binaries, Gentoo packages, AUR, archlinuxcn, NixOS packages, Homebrew for Linux, and FreeBSD ports, alongside source installation with Cargo. That broad packaging spread is notable for a hardware-specific TUI launched only in 2025.

### 使用方式

The tool is run as framework-tool-tui and needs root privileges to access hardware controls. Its architecture polls Framework laptop hardware at intervals, stores a snapshot of hardware data, renders panels in a terminal UI, and dispatches keyboard actions back to hardware mutation methods.

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

Framework System TUI is package-nerd interesting because it packages vendor-specific laptop controls as a terminal-native Rust app rather than a desktop daemon or GUI. It is also a compact example of how a new hardware project can spread quickly across source builds, binary releases, Linux distributions, Homebrew, Nix, and BSD ports.

### 时间线

- 2025: Repository created on August 15.
- 2025: v0.1.0 released with BIOS display, overview panel, README updates, cleanup, and CI.
- 2025: v0.2.0 added charge limit and brightness controls.
- 2025: v0.3.0 added PD port panel and screenshots.
- 2025: v0.4.0 added fan speed information.
- 2026: v0.7.3 release notes describe Windows availability.
- 2026: v0.8.0 added NixOS and official Gentoo installation instructions.
- 2026: v0.8.4 released with dependency and release-maintenance updates.

### Related projects

- The project is related to FrameworkComputer/framework-system and framework_lib for hardware access, ratatui and crossterm for terminal UI, and distro packaging ecosystems including Gentoo, AUR, archlinuxcn, NixOS, Homebrew, and FreeBSD ports.

### 来源

- <https://api.github.com/repos/grouzen/framework-tool-tui>
- <https://github.com/grouzen/framework-tool-tui>
- <https://github.com/grouzen/framework-tool-tui/blob/main/docs/ARCHITECTURE.md>
- <https://github.com/grouzen/framework-tool-tui/releases>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

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

- Nix - framework-tool-tui: normalized package name match | nixpkgs package indexes: pkgs/by-name/fr/framework-tool-tui/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/framework-tool-tui.yml](https://github.com/mxcl/pkgdb/blob/main/combined/framework-tool-tui.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph