Absortio

Email → Summary → Bookmark → Email

Add New Weekly Statistics About
← Back to list
Previous Next

GitHub - lu-zhengda/updater: macOS app update manager — check and update apps from Sparkle, Homebrew, Mac App Store, and GitHub Releases

https://github.com/lu-zhengda/updater • Mar 3, 2026 20:49

Extracto

macOS app update manager — check and update apps from Sparkle, Homebrew, Mac App Store, and GitHub Releases - lu-zhengda/updater

Resumen

Resumen Principal

updater es una herramienta integral de línea de comandos y TUI (Interfaz de Usuario de Texto) diseñada para optimizar la gestión de actualizaciones de software en macOS. Su propósito central es descubrir aplicaciones instaladas, verificar la disponibilidad de actualizaciones en múltiples ecosistemas y aplicar la acción de actualización adecuada para cada aplicación. Esta utilidad consolida un proceso que a menudo requiere el uso de varias herramientas o visitas manuales, ofreciendo una experiencia unificada y eficiente. Se integra profundamente con Homebrew y mas para el Mac App Store, lo que facilita enormemente su instalación y funcionalidad. updater no solo detecta actualizaciones, sino que también ofrece opciones avanzadas de configuración y un robusto modelo de seguridad, incluyendo respaldos y rollbacks

Contenido

CI Release Latest Release Go Version License: MIT

updater is a macOS CLI/TUI that discovers installed apps, checks for updates across multiple ecosystems, and applies the right update action per app.

Requirements

  • macOS (the one truly non-negotiable requirement)
  • Homebrew (recommended)
  • mas for Mac App Store checks (installed automatically with the Homebrew cask)

Install (Recommended)

Install from Homebrew tap:

brew install --cask lu-zhengda/tap/updater
updater --version

This is the easiest path and includes mas automatically as a cask dependency.

Upgrade later:

brew upgrade --cask lu-zhengda/tap/updater

Quick Start

# 1) Validate environment and dependencies
updater doctor

# 2) Discover installed apps and detected sources
updater scan

# 3) Check available updates
updater check

# 4) Preview update actions without changing anything
updater update --all --dry-run

# 5) Apply updates
updater update --all

Launch the interactive TUI:

What It Supports

Source How updates are checked Update behavior
Sparkle Appcast feed from app metadata Direct DMG/ZIP/PKG install when possible, otherwise opens download URL
Homebrew cask brew outdated --cask --greedy --json brew upgrade --cask <token>
Homebrew formula brew outdated --formula --json brew upgrade <formula>
Mac App Store mas outdated mas upgrade <id> or opens App Store updates
GitHub Releases GitHub Releases API Direct install when possible, otherwise opens release asset URL
Electron generic latest-mac.yml from update server Direct install when possible, otherwise opens app
Brew-info fallback brew info --cask --json=v2 If brew-installed: brew upgrade --cask; otherwise opens app
macOS system softwareupdate -l Opens Software Update settings

Also detected (for visibility): Setapp, JetBrains Toolbox, and Adobe apps.

Command Guide

Core update workflow:

updater scan
updater check
updater update "1Password"
updater update --all
updater update --all --auto
updater update --all --dry-run

Scripting/JSON:

updater scan --json
updater check --json
updater outdated --json
updater history --json
updater doctor --json
updater update --all --dry-run --json

Agent mode:

  • All commands support --json.
  • When updater detects it is running inside Codex or Claude Code, JSON output is enabled automatically.
  • Override behavior with UPDATER_AGENT_MODE=0 (force off) or UPDATER_AGENT_MODE=1 (force on).
  • updater update --json is supported for dry-run planning (--dry-run).

Management:

updater pin "Google Chrome"
updater unpin "Google Chrome"
updater policy "Google Chrome" manual
updater install firefox
updater rollback "Firefox"
updater cleanup --days 90
updater cleanup --days 90 --delete

Automation:

updater schedule --interval 24
updater schedule --remove

Configuration

Config file path:

~/.config/updater/config.yaml

Example:

ignored_apps:
  - com.apple.Safari

pinned_apps:
  - com.google.Chrome

# auto | manual | notify-only
policies:
  com.microsoft.VSCode: auto
  com.google.Chrome: manual

github_mappings:
  com.microsoft.VSCode: "microsoft/vscode"

cask_mappings:
  com.readdle.PDFExpert-Mac: "pdf-expert"

github_token: "ghp_..."
max_concurrent: 10
max_backups: 1
interactive_notifications: true

Notes:

  • GITHUB_TOKEN environment variable overrides github_token.
  • cask_mappings are only needed when automatic cask token detection is wrong.
  • Use updater config export and updater config import <file> to move config between machines.

Safety Model

  • --dry-run prints the exact planned actions without making changes.
  • Backups are created before install-based updates when app paths are available.
  • Failed direct installs attempt automatic rollback from backup.
  • Pinned apps are skipped in update --all.
  • policy lets you force per-app behavior (auto, manual, notify-only).

Build From Source

Requires Go 1.25.7+.

git clone https://github.com/lu-zhengda/updater.git
cd updater
make install PREFIX=~/.local

If needed, add to PATH:

export PATH="$HOME/.local/bin:$PATH"

If building from source and you want Mac App Store checks, install mas:

Developer Commands

make build
make test
make clean

License

MIT

Fuente: GitHub