Skip to content

Repository files navigation

Dotfiles

Personal configuration files managed with GNU Stow.

Installation

curl -fsSL https://raw.githubusercontent.com/dbmrq/Dotfiles/master/Bootstrap/install.sh | bash

Supports macOS (Intel/Apple Silicon) and Linux. The installer offers two options:

  • Light: Essential configs only (Vim, Git, Shell) — no cloning required
  • Full: Complete setup with all configurations — interactive, idempotent, resumable

Contents

Directory Description
Bash/ Bash shell configuration
Bootstrap/ Setup scripts and CLI tools
Ghostty/ Ghostty terminal configuration
Git/ Git configuration and aliases
Hammerspoon/ macOS window management
Neru/ Keyboard-driven mouse control (macOS)
OpenCode/ OpenCode CLI config (opencode.jsonc, agents, plugin)
Shell/ Shared shell configuration
SSH/ SSH configuration
TeX/ LaTeX configuration
Vim/ Vim/Neovim configuration
Yazi/ Yazi file manager configuration
Zed/ Zed editor settings
Zellij/ Zellij terminal multiplexer configuration
Zsh/ Zsh configuration
macOS/ macOS-specific configurations

Agent skills

Personal, external, and Apple Xcode agent skills are not tracked here. The canonical source is the dbmrq/agent-skills repo; Bootstrap/skills.sh locates it (override with AGENT_SKILLS_DIR), clones it if absent, and runs its scripts/install-all.sh, which installs into real directories such as ~/.agents/skills and ~/.config/opencode/skills. Run ./Bootstrap/skills.sh status to inspect the current layout.

Usage

After installation, use the dotfiles command:

dotfiles sync     # Pull latest and re-stow
dotfiles update   # Update everything
dotfiles status   # Check git status
dotfiles edit     # Open dotfiles in editor

Individual scripts in Bootstrap/ can also be run independently (brew.sh, stow.sh, prefs.sh, etc.).

Security

This repo only tracks portable configuration. Machine-specific settings and credentials (git identity, GitHub/gh auth, App Store Connect keys, API keys) live in ignored local files or the macOS keychain. See SECRETS.md for what is managed, what is excluded, and how to recreate a new Mac.

About

🏡 There's no place like ~/

Topics

Resources

Stars

76 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages