dotfiles

Cross-platform dev environment powered by Chezmoi + Homebrew. One command to a fully configured machine.

Quick Start · Report Bug · Agent Skill

Features

• Homebrew + apt as source of truth for CLIs (git, gh, kubectl, terraform, …)
• Per-language version managers: fnm (Node), uv (Python), rustup (Rust)
• Pinned upstream installers for tools that need it: gcloud, aws-cli, Snowflake Cortex
• Zsh with Oh My Zsh + Powerlevel10k and pre-generated completions
• Tmux with Ctrl+a prefix, vim keys, Catppuccin cyberdream theme
• Ghostty terminal with cyberdream theme and MonaspiceNe Nerd Font
• Neovim (HEAD) with LSP for all included languages
• AI agents (Claude Code, Gemini, Codex, Copilot) auto-installed via chezmoi
• 34 portable agent skills in dot_agents/skills/ + 7 subagents in dot_agents/agents/
• Chezmoi automation scripts that trigger on apply
• Docker cleanup launchd agent running daily at 3 AM

Quick Start

One-liner (installs Homebrew + chezmoi, then runs chezmoi init --apply):

curl -fsSL https://raw.githubusercontent.com/urmzd/dotfiles/main/install.sh | bash

Or step by step:

# 1. Install Homebrew (macOS) or your distro's package manager (Linux)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Install chezmoi and apply this repo in one shot
sh -c "$(curl -fsLS https://get.chezmoi.io)" -- init --apply urmzd

chezmoi apply installs Brewfile/apt packages, sets up gcloud/aws/cortex from upstream, and installs the AI CLIs. Open a new terminal afterwards.

Usage

Day-to-day

chezmoi diff          # Preview pending dotfile changes
chezmoi apply         # Apply dotfile changes to $HOME
chezmoi add <file>    # Start tracking a new file
chezmoi edit <file>   # Edit source, then apply

Maintenance

dotfiles update          # brew upgrade && chezmoi apply
dotfiles status          # Show installed AI tool versions
dotfiles update-ai       # Re-install AI CLIs at pinned versions
dotfiles cleanup         # Prune build artifacts and caches

What’s installed

CLI essentials (Homebrew on macOS, apt/dnf/pacman on Linux): git, gh, fzf, ripgrep, jq, yq, just, tmux, direnv, chezmoi, tree-sitter, uv, tealdeer, terraform, kubectl, helm, k9s, colima, docker, fnm, deno, go, lua, …see Brewfile.

Version managers (per-language, best-in-class): fnm (Node), uv (Python), rustup (Rust).

Upstream-pinned installers (security/auth fixes ship faster than distro repos):

• gcloud + aws-cli — run_onchange_after_install-cloud-clis.sh.tmpl
• Snowflake Cortex Code — run_onchange_after_install-cortex.sh.tmpl (gated on install_cortex feature flag)

AI tools (installed via run_once_after_install-ai-clis.sh.tmpl, sentinel-gated): Claude Code, Codex, Gemini CLI, GitHub Copilot. Update with dotfiles update-ai.

Adding a new tool

1. Homebrew: add to Brewfile. Linux: add to the apt/dnf/pacman list in run_once_before_install-packages-v2.sh.tmpl.
2. For tools needing version pinning: write a run_onchange_after_install-<name>.sh.tmpl mirroring the cortex / cloud-clis pattern.
3. Run chezmoi apply. Completions regenerate if the package exposes zsh site-functions.

Adding a new dotfile

1. Create or edit the file in your home directory
2. Run chezmoi add <file> to start tracking it
3. Use dot_ prefix naming, private_ for sensitive files, .tmpl for templates
4. Platform-specific blocks use {{ if eq .chezmoi.os "darwin" }}...{{ end }}

Configuration

Chezmoi automation

These scripts run automatically on chezmoi apply:

AI tools

AI coding agents are installed by chezmoi apply (sentinel-gated, no shell-startup cost). Check versions with:

dotfiles status

Claude Code config lives in dot_claude/. Includes settings, custom statusline, and project-scoped skills.

Agent Skills

This repo’s conventions are available as portable agent skills in dot_agents/skills/, following the Agent Skills Specification.

Related standards: AGENTS.md · llms.txt

Managing skills

All skills are installed automatically via chezmoi apply. The install-skills script uses agentspec to install both local skills from dot_agents/skills/ and third-party skills globally to all agents:

To manage skills and agents manually:

agentspec manage list                          # List managed resources with tool linkage
agentspec manage add <source>                  # Add from local path, GitHub (owner/repo), or name
agentspec manage link <name> <tool>            # Link resource to a tool (claude-code, codex, etc.)
agentspec manage remove <name>                 # Remove a managed resource
agentspec manage create [name]                 # Scaffold a new resource
agentspec manage validate [path]               # Validate SKILL.md or agent definition
agentspec status                               # Show managed vs unmanaged inventory
agentspec sync --fast                          # Discover, adopt, link, and verify all resources

All skills

Coding standards

Scaffolding & setup

Workflow automation

AI & documentation

Subagents

Delegation targets in dot_agents/agents/ that adopt a specific reasoning mode:

License

Apache-2.0