Skip to content

v0.1.0

Choose a tag to compare

View all tags
@stevekinney stevekinney released this 04 Aug 22:15
· 4 commits to main since this release
v0.1.0
ec9767d

First working release of battlestation — capture macOS system preferences to an auditable TOML file and restore them on a new machine.

Highlights

  • ~145 curated settings across keyboard, trackpad, Dock, Mission Control, hot corners, Finder, screenshots, appearance, region formats, menu bar, Control Center, window management, and system behavior — including hidden preferences System Settings doesn't expose
  • Structured settings as native TOML: system keyboard shortcuts, text replacements, input sources, Finder view options, default app handlers, and Dock pinned apps
  • Declarative apply with diff preview, confirmation prompt, automatic undo snapshots, and process restarts
  • doctor validation with auto-fix, plus data-driven value domains (choices/ranges) that generate the file's legend comments
  • Agent-friendly: list/get/set/unset file editing, --json output on diff and apply, and a STDIO MCP server (battlestation mcp)
  • Dual Node/Bun builds, a full programmatic API, and per-command --help

Install

npx battlestation capture   # or: bun x battlestation capture

Standalone macOS executables (no runtime required) are attached below: battlestation-darwin-arm64.tar.gz (Apple Silicon) and battlestation-darwin-x64.tar.gz (Intel).

Assets 4
Loading