Installation Reference

Got a new machine? Tired of reading medium articles or sifting through all the latest and greatest plugins that sort-of work?

Same, so I decided to create this repo to help me when I inevitably have to set up a new machine for work/pleasure. I put this together for my personal development needs with the languages that I commonly use. There is a lot more that can be done here, but hopefully this helps someone do what I just did and saves them a few hours.

This script automates the setup of a development environment on macOS. It installs and configures a variety of tools and applications commonly used by developers + myself. This was done quickly with the help of Claude 3.5 Sonnet, so if there are any errors, take it up with Anthropic.

Neovim configs coming soon.

This document provides a list of all tools and applications installed by the setup script, along with their descriptions and official website links.

Prerequisites

• macOS (tested on macOS Sonoma, but should work on recent versions)
• Internet connection
• Administrator privileges

Installation

1. Clone this repository:

   git clone https://github.com/milancr/init_machine.git
   cd init_machine

2. Make the script executable:

   chmod +x init_machine.sh

3. Run the script:

   ./init_machine.sh

Usage

The script is interactive and will prompt you for input at various stages. You can choose which components to install.

Dry Run

To see what the script would do without making any changes to your system, use the --dry-run flag:

./install_dev_environment.sh --dry-run

What Gets Installed

The script can install and configure the following:

• Homebrew
• Oh My Zsh
• Various GUI applications via Homebrew Casks (e.g., Visual Studio Code, Firefox)
• Command-line tools via Homebrew Formulae (e.g., git, node, python)
• Development tools and languages (e.g., Go, Python, Node.js)
• Shell plugins and configurations

For a full list of installations, refer to the installation_reference.md file generated by the script.

Post-Installation

After running the script:

1. Restart your terminal or run source ~/.zshrc to apply all changes.
2. Run p10k configure to set up your Powerlevel10k prompt.
3. Install Docker Desktop from the .dmg file in your Downloads folder.
4. Configure Spotify by running spot in the terminal.
5. Add your OpenAI API key to ~/.config/openaiapirc if you chose to set it up.

Customization

You can customize the script by modifying the lists of casks, formulae, and taps in the script file. Feel free to add or remove items based on your needs, or just hit (n) to avoid installing anything in the script.

Troubleshooting

• Check the log file generated in the logs directory for any error messages.
• If you encounter issues, try running the script with the --dry-run flag to see what steps might be failing.
• Ensure you have a stable internet connection throughout the installation process.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This script makes significant changes to your system. While it's designed to be safe, please review the script and understand the changes it will make to your system before running it. Always ensure you have backups of important data.

Homebrew Casks (GUI Applications)

1. Visual Studio Code - Popular code editor
2. Discord - Communication app for communities
3. Logi Options+ - Logitech device manager
4. Caffeine - Prevent your Mac from going to sleep
5. Figma - Collaborative interface design tool
6. Grammarly - Writing assistant
7. Obsidian - Knowledge base that works on local Markdown files
8. Bitwarden - Open source password manager
9. Firefox - Web browser
10. iTerm2 - Terminal emulator for macOS
11. Postman - API development environment
12. Docker - Platform for building, sharing, and running containerized applications
13. Tor-Browser - Secure browser for anonymous web browsing

Homebrew Formulae (Command Line Tools)

1. Go - Open source programming language
2. Zsh Syntax Highlighting - Fish shell-like syntax highlighting for Zsh
3. fd - Simple, fast and user-friendly alternative to find
4. fzf - Command-line fuzzy finder
5. bat - Cat clone with syntax highlighting and Git integration
6. jq - Lightweight command-line JSON processor
7. Powerlevel10k - Zsh theme
8. pyenv - Python version management
9. pyenv-virtualenv - pyenv plugin for virtualenv
10. Tor - Anonymity network
11. Docker Compose - Define and run multi-container Docker applications
12. ctop - Top-like interface for container metrics
13. lazydocker - Docker management terminal UI
14. AWS CLI - Command-line interface for AWS
15. GitHub CLI - GitHub's official command line tool
16. pgcli - PostgreSQL CLI with autocompletion and syntax highlighting
17. Glow - Markdown reader for the terminal
18. ripgrep - Fast search tool
19. bpytop - Resource monitor
20. lazygit - Simple terminal UI for git commands
21. spotify_player - Command-line Spotify player
22. tmux - Terminal multiplexer
23. tree - Directory listing as a tree
24. Nmap - Network discovery and security auditing tool
25. eza - Modern replacement for ls
26. tldr - Simplified man pages
27. Neovim - Hyperextensible Vim-based text editor
28. tickrs - Real-time stock market ticker
29. Terraform - Infrastructure as Code tool

Homebrew Taps

1. tarkah/tickrs - Tap for tickrs (Real-time stock market ticker)
2. hashicorp/tap - HashiCorp formulae
3. dbcli/tap - Database command-line tools

Additional Tools and Configurations

1. Oh My Zsh - Framework for managing Zsh configuration
2. Node Version Manager (NVM) - Version manager for Node.js
3. Python - Programming language (installed via pyenv)
4. OpenAI Python package - Python client library for the OpenAI API and ZSH_CODEX

Shell Plugins

1. zsh-autosuggestions
2. zsh-syntax-highlighting
3. zsh_codex

Additional Resources

• Homebrew Documentation
• Oh My Zsh Documentation
• Pyenv Documentation
• NVM Documentation
• Docker Documentation

For detailed usage instructions and configuration options, please refer to the official documentation of each tool or application.