heyitsiveen

Interactive CLI to set up dotfiles for macOS and Windows 11. One command to install, theme, backup, and manage your development environment.

Table of Contents

• Quick Start
• Prerequisites
• Tools
• What's Included
• Color Themes
• CLI Flags
• How It Works
• Development

Quick Start

pnpm dlx @heyitsiveen/dotfiles@latest

Or with other package runners:

npx @heyitsiveen/dotfiles@latest
bunx @heyitsiveen/dotfiles@latest
yarn dlx @heyitsiveen/dotfiles@latest

This CLI modifies your home directory. It writes to ~/.config/ (Fish config on macOS) or PowerShell profile (Windows), and other tool-specific paths. Existing configs are backed up to ~/.config/heyitsiveen/dotfiles/backup/ before any overwrite. Preview with --dry-run first. Undo with --restore or --uninstall.

Prerequisites

Tools

The CLI automatically detects all tools and offers to install missing ones via Homebrew (macOS) or winget (Windows).

Required (core tools for the dotfiles):

Note: tree-sitter-cli and a C compiler are only needed if you install Neovim. LazyVim uses them to compile syntax parsers. macOS usually has the C compiler pre-installed via Xcode Command Line Tools.

Optional (enhance the experience):

What's Included

macOS

Windows

⚠️ Claude Code configs are the author's personal setup. settings.json enables specific plugins, sets effortLevel: xhigh, advisorModel: opus, and skips dangerous-mode permission prompts. .claude.json wires three MCP servers (exa, grep, better-auth). CLAUDE.md is the author's 13-rule instruction set. If you prefer defaults, deselect "Claude Code" when the CLI asks which configs to install — or replace the files in ~/.claude/ after install.

Color Themes

Three themes are available across all tools:

Switch themes instantly across all installed tools:

pnpm dlx @heyitsiveen/dotfiles --theme vercel
pnpm dlx @heyitsiveen/dotfiles --theme vesper
pnpm dlx @heyitsiveen/dotfiles --theme solarized-dark

CLI Flags

How It Works

1. Detects your OS (macOS or Windows)
2. Checks for missing tools and offers to install them (brew/winget)
3. Shows available dotfile configurations
4. You select which configs to install
5. You pick a color theme
6. Backs up existing dotfiles (optional — Neovim backups include LazyVim plugin data)
7. Copies configs to the right locations
8. Activates your chosen theme across all tools
9. Checks for updates and notifies you if a new version is available

Subsequent runs detect the existing installation and offer:

• Fresh install — backup + overwrite
• Update — apply changes from a new package version
• Change theme — switch colors across all tools
• Uninstall — remove configs, uninstall tools (brew/winget), or both
• Restore — restore from per-tool timestamped backups

Development

This repo uses pnpm. See docs/pnpm-setup.md if you don't have it — you don't need Node installed first, pnpm brings its own.

# Install dependencies (Node is fetched automatically per devEngines.runtime)
pnpm install

# Build
pnpm run build

# Run locally
node dist/index.mjs

# Run all checks (typecheck + lint + format)
pnpm run check

# Previously (replaced by pnpm — kept for reference):
# npm install && npm run build && npm run check
# bun install && bun run build && bun run check

Pre-commit hooks are set up via husky + lint-staged. Every git commit automatically:

1. Formats staged .ts files with oxfmt
2. Lints staged .ts files with oxlint
3. Typechecks the project with tsc

License

MIT