mac-onboarding

Export and migrate macOS configurations between Macs over Tailscale SSH.

3|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/oleg-koval/mac-onboarding --skill mac-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-onboarding
Source: https://github.com/oleg-koval/mac-onboarding/tree/main
Command: npx skills add https://github.com/oleg-koval/mac-onboarding --skill mac-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires macos, go, homebrew, tailscale, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the process of exporting macOS configuration from a source Mac and installing it on a target Mac, saving time and ensuring consistency across devices.

Core Features & Use Cases

  • Configuration Export: Capture apps, dotfiles, shell config, system settings, hotkeys, and app preferences.
  • Safe Restore Flow: Replay a portable archive on a new Mac with dry-run support.
  • Homebrew Bundle Support: Export ~/.Brewfile and restore packages with brew bundle install.
  • Bridge Mode: Pull configuration live from a source Mac over Tailscale SSH without an intermediate archive.
  • Use Case: If you have a source Mac with a specific setup and want to replicate it on a new Mac, this Skill can automate the process, ensuring that all your configurations are correctly applied.

Quick Start

Use the mac-onboarding skill to export your macOS configuration from your source Mac and install it on your target Mac.

Frequently Asked Questions about mac-onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate macOS configuration to a new Mac?

Migrate macOS configuration by exporting a portable archive of apps, dotfiles, system settings, and Homebrew bundles from a source Mac, then replaying it on the target Mac with dry-run support.

Can I pull macOS setup live from another Mac over SSH?

Yes, you can pull macOS setup live from a source Mac using Bridge Mode over Tailscale SSH, which applies configuration directly without creating an intermediate archive.

Does macOS configuration migration require Tailscale?

Tailscale is required specifically for Bridge Mode to pull live configuration over SSH. Standard archive export and restore workflows do not require it.

How do I backup and restore Homebrew packages on macOS?

Backup and restore Homebrew packages by exporting a Brewfile from the source Mac and running `brew bundle install` on the target Mac to reinstall all dependencies.

What is the best way to automate macOS setup without exposing secrets?

Automate macOS setup safely by generating a portable configuration archive that includes built-in secret redaction, ensuring sensitive data is removed before applying settings to a new Mac.

Do I need Go installed to run macOS configuration migration?

Yes, Go is a required dependency to run the macOS configuration migration scripts, alongside macOS 11+ and Homebrew for package management.