@dotformat/cliMachine Identity CLI

Collect, backup, restore, and diff your configs across machines.

Snapshot

Generate a structured .dotf report of your entire machine config. AI tools, shell, git, editors, brew, apps, SSH, and more.

Backup & Restore

Copy real config files into a categorized directory. Restore on a new machine with conflict resolution, rollback, and interactive picker.

Sensitivity Scan

27+ patterns detect tokens, keys, and secrets. Auto-redact on collect and backup. Never silent about sensitive data.

Diff & Compare

Color-coded diff of backup vs live system. Compare two .dotf reports side by side. Track what changed since last backup.

Registry-Driven

Single source of truth for all config paths. Add a new tool by adding one entry and collection, backup, and restore all stay in sync.

Multi-Platform

macOS, Linux, and Windows path resolution. Per-platform paths in registry entries. Platform guards for OS-specific collectors.

Quick Start

bash

# Snapshot your machine
bunx @dotformat/cli collect

# Back up real files
bunx @dotformat/cli backup

# Restore on a new machine
bunx @dotformat/cli restore ./backup --pick --dry-run

What's in a Snapshot?

A .dotf report captures:

Category	What's Collected
AI Tools	Claude, Cursor, Gemini, Windsurf (settings, skills, MCP configs)
Shell	`.zshrc`
Git	`.gitconfig`, `.gitignore_global`, GitHub CLI
Editors	Zed, Cursor, Neovim, Vim
Terminal	Powerlevel10k, tmux
SSH	Host config (structured + redacted)
Package Managers	npm, Bun, Homebrew (formulae + casks)
Apps	macOS `/Applications`, Raycast, AltTab, Ollama models
Meta	Hostname, OS, architecture, timestamp