Automic VaultAutomic Vault

brew

Install framework-tool-tui with Homebrew, Nix

TUI for controlling and monitoring Framework Computers hardware. Version 0.8.4 via Homebrew; verified 2026-06-30.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install framework-tool-tui

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#framework-tool-tui

nixpkgs package indexes · pkgs/by-name/fr/framework-tool-tui/package.nix · source: api.github.com

overview

Package summary

TUI for controlling and monitoring Framework Computers hardware

Commands and aliases

  • framework-tool-tui

history

Project history and usage

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.

Project history

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.

Adoption history

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.

How it is used

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.

Why package nerds care

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.

Timeline

  • 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.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 1 platform targets.
  • Installs with 1 runtime dependencies.
  • Build metadata lists 2 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
framework-tool-tuicliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.8.4
manager updated2026-06-30
local dataok
upstreamcurrent
latest detectedv0.8.4

https://github.com/grouzen/framework-tool-tui

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:framework-tool-tui
Version0.8.4
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/framework-tool-tui
Homepagehttps://github.com/grouzen/framework-tool-tui
Repositoryhttps://github.com/grouzen/framework-tool-tui
Upstream docshttps://github.com/grouzen/framework-tool-tui#readme
LicenseMIT
Source archivehttps://github.com/grouzen/framework-tool-tui/archive/refs/tags/v0.8.4.tar.gz
Last updated2026-06-30T21:30:31Z
Pulseupdated
Dependenciessystemd
Build dependenciespkgconf, rust
Bottleavailable (on x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameframework-tool-tui
Version Scheme0
Revision0
Head VersionHEAD
Requirements
  • arch
  • linux
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

framework-tool-tui

nix profile install nixpkgs#framework-tool-tui
  • normalized package name match
  • Matched by: Framework Tool Tui
nixpkgs package indexes · api.github.com · 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

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • systemdRuntime dependency declared by Homebrew.
  • pkgconfBuild dependency declared by Homebrew.
  • rustBuild dependency declared by Homebrew.

Same workflow

  • nvtopShares av.db curated category or tags: cli, hardware, monitoring, system, tui.
  • bottomShares av.db curated category or tags: cli, monitoring, rust, system.
  • cymeShares av.db curated category or tags: cli, hardware, rust, system.
  • devcockpitShares av.db curated category or tags: cli, monitoring, system, tui.
  • osx-cpu-tempShares av.db curated category or tags: cli, hardware-monitoring, monitoring, system.
  • owfsShares av.db curated category or tags: cli, hardware, hardware-monitoring, system.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment