dotfiles

This repository contains configuration files (dotfiles) and installation scripts for a personal development environment. It is organized into modular subprojects for various applications and tools.

Subprojects

• alacritty: Alacritty terminal emulator configuration and themes
• nvim: Neovim configuration, plugins, and installer scripts
• tmux: Tmux configuration and helper scripts
• shell: Shell configuration (aliases, environment, git helpers, vi-mode)
• opencode: Agent/tooling configs and references for opencode project
• cursor: Cursor Agent CLI configuration and setup

Installation

Local Installation

Run the top-level installer to symlink configs into the appropriate locations:

./install.sh [all|alacritty|nvim|tmux|opencode|shell|cursor] [--reinstall]

Docker Installation

Use your dotfiles in project containers without modifying shared Dockerfiles:

# Quick start - mount and install
docker run -it -v ~/dotfiles:/root/dotfiles:ro your-project-image bash
/root/dotfiles/docker-install.sh --minimal

# Or use docker-compose.override.yml for persistent setup
cp docker-compose.override.yml.example your-project/docker-compose.override.yml

See DOCKER.md for detailed Docker usage instructions.

Notes

• Install scripts are idempotent and back up existing files when necessary.
• Review each subproject README for specific setup steps and prerequisites.
• Docker installation is designed to be personal and non-invasive to shared projects.