How actuallymentor/battery works
Battery is a macOS menu-bar app and command-line utility for controlling Apple Silicon MacBook charging. The main workflow is tray interaction → app-side battery control → installed CLI → battery/SMC operations; the CLI also supports persistent percentage maintenance, manual charging controls, calibration, and installation management. The GUI initializes and maintains the CLI installation, reads battery status, and reflects status in its tray menu and icon. Relationships for the CLI’s internal behavior are based on README documentation because its implementation was not sampled; the graph does not infer unshown command-level details.
Main entry points: interface.js Tray interface · battery.js Battery manager · battery.sh Battery CLI · settings.js Force-discharge settings
Components 13
Menu-bar app
- Tray interface
app/modules/interface.js - App startup
app/main.js - Tray icon theme
app/modules/theme.js
Battery control
- Battery manager
app/modules/battery.js - Battery CLI
battery.sh - SMC tool
dist/smc - Mac battery
App support
- Force-discharge settings
app/modules/settings.js - Settings store
app/modules/settings.js - Dialogs and logging
app/modules/helpers.js - GUI updater
app/main.js
Other components
- Mac user
- Update services
Connections 14
- Mac user → Tray interface: uses
README.md - App startup → Tray interface: starts
app/main.js - Tray interface → Battery manager: controls and reads
app/modules/interface.js - Tray interface → Tray icon theme: renders icon
app/modules/interface.js - Tray interface → Force-discharge settings: reads and updates
app/modules/interface.js - Battery manager → Battery CLI: runs commands
app/modules/battery.js - Battery manager → Force-discharge settings: reads setting
app/modules/battery.js - Battery CLI → SMC tool: uses tool
README.md - Battery CLI → Mac battery: controls battery
README.md - Force-discharge settings → Settings store: reads and writes
app/modules/settings.js - App startup → GUI updater: configures
app/main.js - GUI updater → Update services: checks updates
README.md - Battery manager → Dialogs and logging: uses dialogs and logs
app/modules/battery.js - Tray interface → Dialogs and logging: logs errors
app/modules/interface.js