Dotfiles

My personal configuration files for development tools and shell environments. I use these across different machines to keep my setup consistent. They work with both Bash and Zsh, include aliases for common tasks, and have some handy scripts for managing secrets and GitHub repositories.

Quick Start

git clone https://github.com/mlorentedev/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
chmod +x install.sh
./install.sh

After installing, restart your shell or run:

source ~/.zshrc  # for Zsh
source ~/.bashrc # for Bash

Prerequisites

• git
• curl or wget
• bash or zsh

What's Inside

├── .bashrc              # Bash configuration
├── .zshrc               # Zsh configuration
├── .profile             # Profile settings
├── .gitconfig           # Git setup
├── .gitignore           # What to ignore
├── .zsh/                # Zsh files
│   ├── aliases.zsh      # Command shortcuts
│   ├── functions.zsh    # Custom functions
│   └── nvm.zsh          # Node version management
├── ai/                  # AI configuration
│   ├── gemini/          # Gemini settings
│   ├── claude/          # Claude settings
│   └── prompts/         # Custom prompts
├── docs/                # Documentation
├── scripts/             # Helper scripts
│   ├── utils.sh                    # Shared utility functions
│   ├── load-secrets.sh             # Secrets management
│   ├── age-encrypt-decrypt.sh      # File encryption
│   ├── github-secrets-manager.sh   # GitHub secrets sync
│   ├── install-precommit.sh        # Git hooks setup
│   └── test.sh                     # Test suite
├── sensitive/           # Encrypted secrets
│   ├── env-mapping.conf            # ENV_VAR=filename mapping
│   └── *.secret.age                # Encrypted files
└── install.sh           # Installer

Documentation

• GUIDE.md - Complete usage and customization guide
• SECRETS.md - Secrets management with age encryption
• TOOLS.md - Tool installation instructions

Features

Shell improvements, development setup, security features, and AI integration. See GUIDE.md for details.

Tools

Required:

• Git
• Bash 4+ or Zsh 5+

Recommended:

• Oh My Zsh, eza, zoxide, direnv, age

See TOOLS.md for installation instructions.

Security

Secrets are encrypted with age and automatically loaded as environment variables on shell startup.

secrets_list     # Show loaded secrets
secrets_add      # Add new secret
secrets_rotate   # Update existing secret

See SECRETS.md for full documentation.

Contributing

Fork it, make changes, submit a pull request.

Related Projects

• Boilerplates - Project templates
• Cheatsheets - Quick references
• My list - More detailed explanations

License

MIT License - use it however you want.