index-knowledge

This repository contains my personal development environment configuration, managed through a custom CLI tool called dot. It uses GNU Stow for symlink management, Homebrew for package installation, and includes configurations for Fish shell, Neovim, Tmux, Git, and other essential development tools.

Key Features

• 🚀 One-command setup - Complete development environment in minutes
• 🤖 AI Integration - OpenCode for commit summaries and assistance
• 📦 Resilient Package Management - Continues installation even if packages fail
• 🔍 Health Monitoring - Comprehensive environment diagnostics
• 🛠️ Modular Design - Separate work and personal configurations

```bash

# Clone the repository

git clone https://github.com/dmmulroy/.dotfiles.git ~/.dotfiles

cd ~/.dotfiles

# Full setup (installs everything)

./dot init

# Or customize the installation

./dot init --skip-ssh --skip-font

```

After installation, the dot command will be available globally for ongoing management. Running dot without arguments shows help.

```

~/.dotfiles/

├── dot # Main CLI tool

├── home/ # Configuration files (stowed to ~)

│ ├── .config/

│ │ ├── fish/ # Fish shell configuration

│ │ ├── git/ # Git configuration

│ │ ├── nvim/ # Neovim configuration

│ │ ├── tmux/ # Tmux configuration

│ │ └── ...

│ └── .ideavimrc # IntelliJ IDEA Vim config

├── packages/

│ ├── bundle # Base Brewfile

│ └── bundle.work # Work-specific packages

├── CLAUDE.md # Instructions for AI assistants

└── README.md # This file

```

The dot command is a comprehensive management tool for your dotfiles. It handles everything from initial setup to ongoing maintenance and provides AI-powered insights.

Installation Commands

#### dot init - Initial Setup

Complete environment setup with all tools and configurations.

```bash

# Full installation

dot init

# Skip SSH key generation

dot init --skip-ssh

# Skip font installation

dot init --skip-font

# Skip both SSH and font setup

dot init --skip-ssh --skip-font

```

What it does:

1. Installs Homebrew (if not present)
2. Installs packages from Brewfiles
3. Creates symlinks with GNU Stow
4. Installs Bun runtime
5. Installs OpenCode CLI via Homebrew (with native installer/bun/npm fallback)
6. Generates SSH key for GitHub (optional)
7. Installs MonoLisa font (optional)
8. Sets up Fish shell with plugins

Maintenance Commands

#### dot update - Update Everything

```bash

dot update

```

• Pulls latest dotfiles changes (auto-detects jj vs git)
• Updates Homebrew packages
• Re-stows configuration files

#### dot doctor - Health Check

```bash

dot doctor

```

Comprehensive diagnostics including:

• ✅ Homebrew installation
• ✅ Essential tools (git, nvim, tmux, node, etc.)
• ✅ OpenCode installation method and functionality
• ✅ Fish shell configuration
• ✅ PATH configuration
• ⚠️ Broken symlinks detection
• ⚠️ Missing dependencies

#### dot check-packages - Package Status

```bash

dot check-packages

```

Shows which packages are installed vs. missing from your Brewfiles.

#### dot retry-failed - Retry Failed Installations

```bash

dot retry-failed

```

Attempts to reinstall packages that failed during initial setup.

AI-Powered Features

#### dot summary - Commit Analysis

Uses OpenCode to generate intelligent summaries of recent git commits.

```bash

# Summarize last 3 commits (default)

dot summary

# Summarize specific number of commits

dot summary -n 5

# Include file diffs for detailed analysis

dot summary -d

# Verbose mode with commit details

dot summary -v

# Combine options

dot summary -n 10 -d -v

```

Example Output:

```

=> Sum