Levonk's Dotfiles

A modern, modular, and security-conscious dotfiles system managed by chezmoi.

What This Is

This is my personal dotfiles repository that configures a Linux/macOS development environment with:

• Shell aliases and functions for productivity (Bash/Zsh compatible)
• Development tools configuration (Git, Neovim, Docker, etc.)
• Security best practices (SSH config, GPG, secrets management)
• AI workflow templates for various development scenarios
• Modular structure - easy to customize and extend

Quick Start

1. Install Prerequisites

# Linux (Debian/Ubuntu)
sudo apt update && sudo apt install -y git curl

# macOS (Homebrew)
brew update && brew install git curl

2. Install chezmoi

# Package manager (recommended)
sudo apt install chezmoi          # Debian/Ubuntu
brew install chezmoi              # macOS

# Or official installer
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b "$HOME/.local/bin"

3. Apply My Dotfiles

chezmoi init --apply git@github.com:levonk/dotfiles.git

That's it! Your system is now configured with my preferred settings.

What You Get

Shell Experience

• Smart aliases for common commands
• Git workflow helpers
• Directory navigation shortcuts
• Modern tool notifications and typo correction

Development Environment

• Optimized Git configuration
• Neovim with plugins and settings
• Docker and container tools setup
• Rust/Cargo toolchain integration

Security & Privacy

• Hardened SSH configuration
• GPG key management
• Secrets handling with chezmoi
• Privacy-focused browser settings

AI Workflows

• Templates for code review, debugging, and documentation
• Advisory panel generation for complex decisions
• Communication pattern guides

Customization

This is my personal configuration, but it's designed to be modular:

1. Fork the repository to make it your own
2. Edit what you need - most settings are in dot_config/shells/shared/
3. Remove what you don't - each module is independent

See AGENT.md for detailed technical documentation and troubleshooting.

Daily Usage

Update Your Dotfiles

chezmoi update
chezmoi apply

Edit a Configuration File

chezmoi edit ~/.gitconfig  # Opens the source template for editing

Check What Would Change

chezmoi diff  # Shows what would be applied

Add Your Own Files

chezmoi add ~/.my-new-config

Support

• For users: Check the chezmoi documentation
• For developers: See AGENT.md for technical details
• Issues: Open a GitHub issue for bugs or feature requests

License

MIT - feel free to use and modify for your own setup.

---

Note: This is a personal dotfiles repository. Some configurations are specific to my workflow and preferences. Fork and customize as needed!