@dotformat/cli 0.1.1

package/README.md

@@ -0,0 +1,11 @@
+# @dotformat/cli
+
+Personal dotfiles CLI — collect, sync, and manage configs across machines.
+
+## Usage
+
+```bash
+bunx @dotformat/cli
+```
+
+Generates a report of all installed AI skills, MCP servers, plugins, shell config, git config, and editor settings.

package/README.md.bak

@@ -0,0 +1,228 @@
+# dotfiles
+
+Personal configuration files and custom AI skills synced across machines. Optimized for fast setup on new/replacement machines.
+
+> **The big picture:** This repo syncs configs, but the real goal is a curated **superskill** — a single skill that encodes my preferred development workflow (web, mobile, animations, email, etc.) by composing the best community skills. One update here propagates to every AI tool on every machine via `skills.sh`.
+
+## Machines
+
+| Machine | OS | Shell | Primary Use |
+|---|---|---|---|
+| Home Mac | macOS | zsh (oh-my-zsh + p10k) | Primary dev machine |
+| Work Mac | macOS | zsh (oh-my-zsh + p10k) | Dev — mostly synced with personal, few extras |
+| Home Windows | Windows | — | Non-dev (Stable Diffusion, etc.) |
+
+## Structure
+
+```
+dotfiles/
+├── ai/                        # AI tools — first-class configs
+│   ├── claude/
+│   │   ├── CLAUDE.md          # Global Claude Code instructions/rules
+│   │   └── settings.json     # Enabled plugins & preferences
+│   ├── cursor/
+│   │   ├── mcp.json           # MCP server configs
+│   │   └── rules/             # Cursor rules (if any)
+│   ├── gemini/
+│   │   ├── GEMINI.md          # Gemini CLI rules/directives
+│   │   └── settings.json     # Gemini preferences
+│   ├── windsurf/
+│   │   └── mcp_config.json   # MCP server configs
+│   └── shared/
+│       ├── ai-tools.md        # Full skills/plugins/MCP inventory (superskill blueprint)
+│       └── mcp-servers.md     # Canonical MCP server list & setup notes
+├── shell/
+│   ├── .zshrc                 # Main zsh config (shared)
+│   ├── aliases.zsh            # Shared aliases
+│   └── exports.zsh            # Shared exports & PATH
+├── git/
+│   ├── .gitconfig             # Global git config
+│   └── .gitignore_global      # Global gitignore
+├── editor/
+│   ├── cursor/
+│   │   └── settings.json     # Cursor editor settings
+│   ├── vscode/
+│   │   └── settings.json     # VS Code editor settings
+│   └── zed/
+│       └── settings.json     # Zed editor settings
+├── terminal/
+│   └── .p10k.zsh             # Powerlevel10k theme config
+├── skills/                        # Custom AI skills (the main event)
+│   ├── superskill/
+│   │   ├── skill.md               # The superskill — composable dev workflow
+│   │   └── README.md              # What it does, which sub-skills, boundaries
+│   ├── web-dev/                   # Web app development skill
+│   │   └── skill.md
+│   ├── mobile-dev/                # Mobile app development skill
+│   │   └── skill.md
+│   └── skills.sh                  # Installer — symlinks skills to all AI tools
+├── apps/
+│   ├── Brewfile               # Homebrew formulae & casks
+│   └── apps.md                # Full app list with install sources
+├── macos/
+│   └── defaults.sh           # macOS system preferences
+├── setup/
+│   └── install.sh            # macOS installer
+├── CLAUDE.md                  # Project-level Claude instructions
+└── README.md
+```
+
+> **Note:** `ai/cursor/` holds MCP/rules configs (from `~/.cursor/`), while `editor/cursor/` holds editor settings (from `~/Library/Application Support/Cursor/`). Same tool, different config scopes.
+
+## Collect Machine Config
+
+Generate a report of all AI tools, skills, MCPs, shell, git, and editor configs on any machine. No clone needed.
+
+```bash
+bunx @doguyilmaz/dotfiles
+```
+
+Or if the repo is already cloned:
+
+```bash
+bash ~/dotfiles/setup/collect-machine-config.sh
+```
+
+Report is saved to `reports/` (in repo) or `~/` (standalone).
+
+## Quick Start
+
+> TODO: Will be implemented in Phase 4
+
+```bash
+git clone https://github.com/doguyilmaz/dotfiles.git ~/dotfiles
+cd ~/dotfiles
+./setup/install.sh
+```
+
+## Roadmap
+
+### Phase 1 — Organize & Sync Configs
+
+Get all config files into the repo with a clean structure. AI configs are top priority.
+
+**AI Tools:**
+- [ ] Add Claude Code configs (`ai/claude/CLAUDE.md`, `ai/claude/settings.json`)
+- [ ] Add Cursor MCP config (`ai/cursor/mcp.json`)
+- [ ] Add Gemini CLI configs (`ai/gemini/GEMINI.md`, `ai/gemini/settings.json`)
+- [ ] Add Windsurf MCP config (`ai/windsurf/mcp_config.json`)
+- [ ] Create shared MCP servers reference (`ai/shared/mcp-servers.md`)
+
+**Shell & Git:**
+- [ ] Move `.zshrc` to `shell/.zshrc`
+- [ ] Add `.gitconfig` and `.gitignore_global` to `git/`
+
+**Editors & Terminal:**
+- [ ] Add Zed settings to `editor/zed/`
+- [ ] Add `.p10k.zsh` to `terminal/`
+
+**Repo Hygiene:**
+- [ ] Add `.gitignore` to exclude secrets, caches, API keys
+- [ ] Update symlink reference in README
+
+### Phase 2 — Clean Up & Cross-Machine Support
+
+Make configs portable across machines and usernames.
+
+- [ ] Replace hardcoded `/Users/dogukyilmaz/` with `$HOME` in all configs
+- [ ] Remove duplicate blocks in `.zshrc` (bun, fnm are duplicated)
+- [ ] Remove stale/placeholder paths (e.g. `~/path/to/zig`)
+- [ ] Split `.zshrc` into shared + platform-specific files (source conditionally)
+- [ ] Add OS detection for platform-specific blocks
+
+### Phase 3 — Superskill (Core Vision)
+
+A curated, composable skill that encodes the preferred dev workflow. Shared across all AI tools via `skills.sh`.
+
+**Research & Design** (using `ai/shared/ai-tools.md` as blueprint)**:**
+- [ ] Audit all currently installed skills across Claude, Cursor, Windsurf, Gemini
+- [ ] Compare with work Mac report — merge skill inventories
+- [ ] Categorize: which skills for web, mobile, animations, email, infra, etc.
+- [ ] Define boundaries: when each skill applies, in what context, why
+- [ ] Use `find-skills` to discover additional community skills worth including
+- [ ] Map skill references (Software Mansion animations, Resend react-email, Vercel, Callstack RN, Expo)
+
+**Build:**
+- [ ] Design superskill structure (directives + sub-skill references)
+- [ ] Create `skills/superskill/skill.md` — the main composable skill
+- [ ] Create domain-specific sub-skills if needed (`web-dev/`, `mobile-dev/`)
+- [ ] Create `skills/skills.sh` — installer that symlinks to `~/.claude/skills/`, `~/.cursor/skills/`, `~/.gemini/skills/`, `~/.codeium/windsurf/skills/`
+- [ ] Test across Claude Code, Cursor, Windsurf, Gemini CLI
+- [ ] Document skill boundaries and usage in `skills/superskill/README.md`
+
+### Phase 4 — Installer Script
+
+One command to set up a new machine. Critical for work Mac migrations.
+
+- [ ] Create `setup/install.sh` for macOS
+  - [ ] Detect OS and architecture
+  - [ ] Backup existing configs before overwriting
+  - [ ] Copy configs to their destinations (backup originals first)
+  - [ ] Install Homebrew + Brewfile (formulae, casks, Mac App Store apps)
+  - [ ] Install oh-my-zsh + plugins (zsh-autosuggestions, zsh-syntax-highlighting)
+  - [ ] Install dev tools (bun, fnm, etc.)
+- [ ] Create `apps/Brewfile` with all Homebrew dependencies
+- [ ] Symlink shared skills across AI tools (Claude/Cursor/Windsurf/Gemini point to one copy)
+- [ ] Add uninstall/restore script (restore backups)
+
+### Phase 5 — Work vs Personal Separation
+
+Keep work-specific configs separate without leaking into personal.
+
+- [ ] Define strategy: profiles directory vs conditional sourcing
+- [ ] Add `shell/.zshrc.work` for work-specific aliases, paths, env vars
+- [ ] Add work `.gitconfig` overrides (different email, signing key)
+- [ ] Document how to activate work profile on work machine
+- [ ] Ensure no work secrets end up in the repo
+
+### Phase 6 — App Installation & macOS Setup
+
+Full machine provisioning: install apps, set system preferences.
+
+- [ ] Create `apps/Brewfile` with all apps (formulae + casks + MAS)
+- [ ] Create `apps/apps.md` listing all apps with install sources
+- [ ] Add `macos/defaults.sh` for system preferences (Dock, Finder, keyboard, etc.)
+- [ ] Add Raycast config/preferences export
+- [ ] Add AltTab preferences export
+- [ ] Add SSH config template (without keys)
+
+### Phase 7 — Nice to Have
+
+- [ ] Evaluate chezmoi if templating needs grow
+- [ ] Add GitHub CLI config (`gh/`)
+- [ ] Windows setup script (`setup/install.ps1`) if needed
+- [ ] Add Homebrew bundle dump automation (keep Brewfile in sync)
+
+## Config Sync Strategy
+
+**Copy-based** — the repo is the source of truth. The installer copies configs to their destinations (with backup). No symlinks for primary configs.
+
+**Symlinks only for shared references** — when multiple tools need the same file (e.g. skills shared across Claude/Cursor/Windsurf/Gemini), the primary copy lives in one location and other tools symlink to it. One source on disk, no drift.
+
+### Install Reference
+
+```bash
+# --- AI Tools (copy to home) ---
+cp ~/dotfiles/ai/claude/CLAUDE.md ~/.claude/CLAUDE.md
+cp ~/dotfiles/ai/claude/settings.json ~/.claude/settings.json
+cp ~/dotfiles/ai/cursor/mcp.json ~/.cursor/mcp.json
+cp ~/dotfiles/ai/gemini/GEMINI.md ~/.gemini/GEMINI.md
+cp ~/dotfiles/ai/gemini/settings.json ~/.gemini/settings.json
+cp ~/dotfiles/ai/windsurf/mcp_config.json ~/.codeium/windsurf/mcp_config.json
+
+# --- Shell ---
+cp ~/dotfiles/shell/.zshrc ~/.zshrc
+
+# --- Git ---
+cp ~/dotfiles/git/.gitconfig ~/.gitconfig
+cp ~/dotfiles/git/.gitignore_global ~/.gitignore_global
+
+# --- Editors ---
+cp ~/dotfiles/editor/zed/settings.json ~/.config/zed/settings.json
+
+# --- Terminal ---
+cp ~/dotfiles/terminal/.p10k.zsh ~/.p10k.zsh
+
+# --- Skills (symlink — shared across tools) ---
+# e.g. ~/.cursor/skills/superskill -> ~/.claude/skills/superskill
+```

package/bin/dotfiles.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+const { execFileSync } = require("child_process");
+const { join } = require("path");
+
+execFileSync("bash", [join(__dirname, "..", "setup", "collect-machine-config.sh")], { stdio: "inherit" });

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@dotformat/cli",
+  "version": "0.1.1",
+  "description": "Collect, compare, and sync machine configs across machines",
+  "type": "module",
+  "bin": {
+    "dotfiles": "./bin/dotfiles.js"
+  },
+  "files": [
+    "bin/dotfiles.js",
+    "setup/collect-machine-config.sh"
+  ],
+  "keywords": [
+    "dotfiles",
+    "dotf",
+    "cli",
+    "config",
+    "machine-state",
+    "sync"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doguyilmaz/dotfiles.git"
+  },
+  "homepage": "https://github.com/doguyilmaz/dotfiles#readme"
+}

package/setup/collect-machine-config.sh

@@ -0,0 +1,188 @@
+#!/bin/bash
+# Collects AI tool configs and system info from any machine.
+# Run on work Mac, then copy the output file back to compare.
+#
+# Usage:
+#   bash collect-machine-config.sh           # outputs to ./reports/ if in repo, else ~/
+#   bash collect-machine-config.sh -o /path  # custom output directory
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(dirname "$SCRIPT_DIR")"
+HOSTNAME="$(hostname -s)"
+FILENAME="dotfiles-report-${HOSTNAME}.md"
+
+OUTPUT_DIR=""
+while getopts "o:" opt; do
+  case $opt in
+    o) OUTPUT_DIR="$OPTARG" ;;
+    *) ;;
+  esac
+done
+
+if [ -n "$OUTPUT_DIR" ]; then
+  mkdir -p "$OUTPUT_DIR"
+elif [ -d "$REPO_ROOT/reports" ] || [ -d "$REPO_ROOT/.git" ]; then
+  OUTPUT_DIR="$REPO_ROOT/reports"
+  mkdir -p "$OUTPUT_DIR"
+else
+  OUTPUT_DIR="$HOME"
+fi
+
+REPORT="$OUTPUT_DIR/$FILENAME"
+
+{
+  echo "# Machine Config Report"
+  echo "- **Host:** $HOSTNAME"
+  echo "- **OS:** $(uname -s) $(uname -m)"
+  echo "- **Date:** $(date +%Y-%m-%d)"
+  echo ""
+
+  echo "## Claude Code"
+  echo "### settings.json"
+  echo '```json'
+  cat ~/.claude/settings.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### CLAUDE.md"
+  echo '```markdown'
+  cat ~/.claude/CLAUDE.md 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Cursor"
+  echo "### mcp.json"
+  echo '```json'
+  cat ~/.cursor/mcp.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### Skills"
+  echo '```'
+  ls ~/.cursor/skills/ 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Gemini CLI"
+  echo "### settings.json"
+  echo '```json'
+  cat ~/.gemini/settings.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### GEMINI.md"
+  echo '```markdown'
+  cat ~/.gemini/GEMINI.md 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### Skills"
+  echo '```'
+  ls ~/.gemini/skills/ 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Windsurf"
+  echo "### mcp_config.json"
+  echo '```json'
+  cat ~/.codeium/windsurf/mcp_config.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### Skills"
+  echo '```'
+  ls ~/.codeium/windsurf/skills/ 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Shell"
+  echo "### .zshrc"
+  echo '```bash'
+  cat ~/.zshrc 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Git"
+  echo "### .gitconfig"
+  echo '```ini'
+  cat ~/.gitconfig 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Editors"
+  echo "### Zed settings.json"
+  echo '```json'
+  cat ~/.config/zed/settings.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo "### Cursor editor settings"
+  echo '```json'
+  cat ~/Library/Application\ Support/Cursor/User/settings.json 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Terminal"
+  echo "### p10k theme"
+  echo '```'
+  [ -f ~/.p10k.zsh ] && echo "(exists, $(wc -l < ~/.p10k.zsh) lines)" || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## SSH Config"
+  echo '```'
+  if [ -f ~/.ssh/config ]; then
+    # Redact IP addresses and key paths for safety
+    sed 's/HostName .*/HostName [REDACTED]/; s/IdentityFile .*/IdentityFile [REDACTED]/' ~/.ssh/config
+  else
+    echo "(not found)"
+  fi
+  echo '```'
+  echo ""
+
+  echo "## GitHub CLI"
+  echo '```yaml'
+  cat ~/.config/gh/config.yml 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## npm config (.npmrc)"
+  echo '```'
+  if [ -f ~/.npmrc ]; then
+    # Redact auth tokens
+    sed 's/_authToken=.*/_authToken=[REDACTED]/' ~/.npmrc
+  else
+    echo "(not found)"
+  fi
+  echo '```'
+  echo ""
+
+  echo "## Bun config (bunfig.toml)"
+  echo '```toml'
+  cat ~/.bunfig.toml 2>/dev/null || echo "(not found)"
+  echo '```'
+  echo ""
+
+  echo "## Raycast"
+  echo '```'
+  [ -d "/Applications/Raycast.app" ] && echo "(installed)" || echo "(not installed)"
+  echo '```'
+  echo ""
+
+  echo "## AltTab"
+  echo '```'
+  if [ -d "/Applications/AltTab.app" ]; then
+    echo "(installed)"
+    defaults read com.lwouis.alt-tab-macos 2>/dev/null | head -30 || echo "(no preferences found)"
+  else
+    echo "(not installed)"
+  fi
+  echo '```'
+  echo ""
+
+  echo "## macOS Apps (/Applications)"
+  echo '```'
+  ls /Applications/ 2>/dev/null | sort || echo "(unable to list)"
+  echo '```'
+  echo ""
+
+  echo "## Homebrew"
+  echo '```'
+  brew list --formula 2>/dev/null | sort || echo "(brew not found)"
+  echo '```'
+  echo "### Casks"
+  echo '```'
+  brew list --cask 2>/dev/null | sort || echo "(brew not found)"
+  echo '```'
+
+} > "$REPORT"
+
+echo "Report saved to: $REPORT"