Main CLI binary for dotty - a beautiful CLI for managing dotfiles on macOS.
npm install @dottyfiles/cliMain CLI binary for dotty - a beautiful CLI for managing dotfiles on macOS.
``bash`
npm install -g @dottyfiles/cli
`bash`
dotty # Interactive menu
dotty status # Show dotfiles status
dotty sync # Pull and apply changes
dotty diff # Preview pending changes
dotty apply # Apply dotfiles to system
dotty doctor # Check system health
dotty edit
dotty add
| Option | Description |
|--------|-------------|
| -y, --yes | Skip confirmation prompts |--dry-run
| | Show what would be done without doing it |-V, --version
| | Output version number |-h, --help
| | Display help |
Opens an interactive menu to select an action.
Shows the status of your dotfiles including:
- Pending file changes
- Run scripts to execute
- Git status of dotfiles repo
Pulls changes from remote and applies them. Equivalent to chezmoi update`.
Shows a diff of pending changes before applying.
Applies all pending dotfile changes to your system.
Checks system health and dependencies:
- Core tools: brew, chezmoi, git, node, pnpm
- Optional tools: dockutil, mas
- Directories: dotfiles, chezmoi source, TPM, zsh plugins
- Package version consistency
Opens a managed dotfile in your editor via chezmoi.
Adds a new file to dotfiles management.
- Node.js 18+
- macOS (for full functionality)
- chezmoi (for dotfile management)
- Homebrew (optional, for brew operations)
- mas (optional, for Mac App Store operations)
- @dottyfiles/core - Shared utilities
- @dottyfiles/chezmoi - Chezmoi wrapper
- @dottyfiles/homebrew - Homebrew integration
- @dottyfiles/mas - Mac App Store integration
MIT