# Install batt with Homebrew Control and limit battery charging on Apple Silicon MacBooks. Version 0.8.0 via Homebrew; verified 2026-07-21. ## Install ```sh sudo av install brew:batt ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install batt ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:batt - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.8.0 - **Source summary:** Control and limit battery charging on Apple Silicon MacBooks - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-only - **Source archive:** - **Last updated:** 2026-07-21T07:10:34Z - **Generated:** 2026-07-26T07:20:29+00:00 ## Executables - batt (cli) - batt (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Service: declared - Caveats: The batt service must be running as root before most of batt's commands will work. - Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe ## Freshness - Page generated: 2026-07-26 - Package-manager version: 0.8.0 - Package-manager updated: 2026-07-21 - Local data: ok - Upstream repository: https://github.com/charlie0129/batt - info: No cached GitHub release or tag data was available. ## Project history and usage batt is a macOS utility for controlling and limiting battery charging on Apple Silicon MacBooks, available as a command-line daemon/client and a native menu-bar app. ### Project history The README states the maintainer created batt because existing tools were unsatisfactory. It focuses on predictable charge limiting, with the common use case of stopping charge around a configured maximum such as 80 percent. batt's design is intentionally daemon-based: the README compares it to docker, with a client sending requirements to a background daemon that performs the charging control. By 2026, the README notes a changed platform landscape: macOS 26.4 and later supports native charge limiting from 80 to 100 percent, while batt remains useful on older macOS versions or when users want limits below 80 percent. ### Adoption history batt is Homebrew-packaged and its README documents `brew install batt` followed by running it as a brew service. It also offers an installation script and release binaries. The repository page showed about 1.6k stars at enrichment time, reflecting a niche but visible Apple Silicon power-user audience. ### How it is used Typical CLI usage is to install the daemon, check status with `sudo batt status`, set an upper charge limit with commands such as `sudo batt limit 80`, disable the limit with `batt disable` or `batt limit 100`, and optionally control adapter power. Advanced usage includes lower and upper charge bands, MagSafe LED control, idle/sleep handling, automatic calibration, scheduled calibration, and logs under `/tmp/batt.log`. ### Why package nerds care batt is interesting because it is a package-manager-distributed hardware-control tool that depends on private-feeling macOS power behavior and firmware compatibility rather than a stable cross-platform Unix API. It also captures a packaging moment: before native macOS charge limits became broader, power users installed a daemon through Homebrew to get ThinkPad-style charge thresholds on Apple Silicon MacBooks. ### Timeline - 2025: v0.4.1 release highlights an experimental GUI and macOS Tahoe compatibility work. - 2026: README update says macOS 26.4 adds native charge limiting, reducing batt's necessity for some users. - 2026: v0.7.x releases include auto-calibration and scheduling work. ### Related projects - The README links third-party GUI projects BattGUI and batt-helper. - macOS Optimized Battery Charging and macOS 26.4 native charge limiting are the platform features batt complements or replaces depending on OS version. ### Sources - - - source_facts.package-manager ## Security Notes formula declares a Homebrew service. - **Geiger risk:** orange / medium - formula declares a Homebrew service ## 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 - macOS: /opt/homebrew/etc/batt.json, /etc/batt* ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** batt - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** arch, macos - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [devcockpit](https://www.automicvault.com/pkg/brew/devcockpit/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [lume](https://www.automicvault.com/pkg/brew/lume/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [m1ddc](https://www.automicvault.com/pkg/brew/m1ddc/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [macmon](https://www.automicvault.com/pkg/brew/macmon/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [mactop](https://www.automicvault.com/pkg/brew/mactop/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [asimov](https://www.automicvault.com/pkg/brew/asimov/) - Shares av.db curated category or tags: cli, macos, system. - [bluetoothconnector](https://www.automicvault.com/pkg/brew/bluetoothconnector/) - Shares av.db curated category or tags: cli, macos, system. ## Combined YAML source View the package source record on GitHub. [combined/batt.yml](https://github.com/automic-vault/db/blob/main/combined/batt.yml) ## Sources - 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 - cross-ecosystem install command graph