GitHub - yatish27/omakos: Opinionated macOS setup

Omakos turns your macOS laptop into a fully functional development machine in a single command. A shell script to setup a new mac.

Omakos is inspired by Basecamp's Omakub project. The name is a combination of "omakase" (お任せ, Japanese for "I leave it up to you") and "macOS", reflecting its purpose of providing a curated development environment setup for macOS.

It can be run multiple times on the same machine safely. It installs, upgrades, or skips packages based on what is already installed on the machine.

Install

You can install Omakos using one of these two methods:

Option 1: Direct Install (Recommended)

Run this single command in your terminal:

curl -L https://raw.githubusercontent.com/yatish27/omakos/main/install.sh | bash

Option 2: Manual Install

If you prefer to review the code first:

1. Download the repo:

git clone https://github.com/yatish27/omakos.git && cd omakos

2. Review the scripts (please don't run scripts you don't understand):

3. Run the setup:

./setup.sh 2>&1 | tee ~/omakos.log

Just follow the prompts and you'll be fine. 👌

What it sets up

The setup process will install and configure the following tools and applications. All packages are managed through Homebrew and defined in configs/Brewfile.

Command Line Tools

• XCode Command Line Tools for developer essentials
• Git for version control
• Homebrew for managing operating system libraries
• ZSH with Oh My Zsh for a better shell experience
• coreutils for GNU file, shell and text manipulation utilities
• curl and wget for downloading files
• fzf for command-line fuzzy finding
• jq for JSON processing
• btop for system resource monitoring
• fastfetch for system information display
• ffmpeg for video processing
• gh for GitHub CLI integration
• libyaml for YAML parsing

Development Environment

• Cursor - AI-powered code editor
• Neovim with LazyVim - Modern Vim-based editor
• Zed - High-performance code editor
• Ghostty - Modern terminal emulator
• Docker for containerization
• OrbStack for Docker and Linux development on macOS
• PostgreSQL 17 with libpq for database management
• Redis for in-memory data store
• jemalloc for memory allocation
• vips for image processing (automatically installs configured runtimes if ~/.mise.toml exists)
• Ollama for local AI models
• Overmind for process management
• Mise for runtime version management. The Mise configuration is present in mise.toml. It installs
  • Python
  • Ruby
  • Rust
  • Go
  • Node
• UV for Python packaging
• pnpm for Node.js package management

Productivity & Communication

• 1Password for password management
• Brave Browser for web browsing
• ChatGPT for AI assistance
• Claude for AI assistance
• Discord for communication
• IINA for media playback
• iTerm2 for terminal emulation
• LocalSend for cross-platform file sharing
• NetNewsWire for RSS reading
• Obsidian for note-taking
• Mole for Mac maintenance and cleaning
• Raycast for productivity launcher
• Rectangle for window management
• Slack for team communication
• SuperWhisper for voice transcription
• WhatsApp for messaging
• Zoom for video conferencing

Fonts

• Cascadia Code
• Cascadia Mono
• Commit Mono
• DM Sans
• Fira Code
• Geist
• Geist Mono
• Google Sans Code
• Hack
• IBM Plex Mono
• IBM Plex Sans
• Work Sans

Enhanced macOS Settings

The setup applies developer-optimized macOS configurations including:

• Performance: Near-instant window animations and faster Mission Control
• Finder: Opens to home directory, searches current folder by default, shows hidden files
• Text Editing: Key repeat enabled in all apps, faster cursor movement
• Screenshots: Organized in ~/Desktop/Screenshots/ folder without shadows
• Trackpad: Three-finger drag enabled for better window management
• Keyboard: Fastest repeat rates for efficient coding
• System: Disabled automatic corrections, expanded dialogs, local saves by default

Features

Modular Scripts

Each script in the scripts/ directory can be run independently:

# Run individual scripts
./scripts/mac.sh       # Only configure macOS settings
./scripts/git.sh       # Only setup Git configuration
./scripts/cursor.sh    # Only configure Cursor editor
./scripts/nvim.sh      # Only configure Neovim with LazyVim
./scripts/zed.sh       # Only configure Zed editor
./scripts/mise.sh      # Only setup mise and install configured runtimes
./scripts/rubocop.sh   # Only setup Rubocop configuration
./scripts/gemrc.sh     # Only setup Gem configuration
./scripts/irbrc.sh     # Only setup IRB configuration
./scripts/zshrc.sh     # Only setup Zsh configuration
./scripts/ssh.sh       # Only configure SSH settings

The scripts are designed to be:

• Independent: Each script can run on its own
• Idempotent: Safe to run multiple times
• Configurable: Easy to modify for your needs

Code Structure

The project follows a modular structure where each component is responsible for a specific setup task. You can run any script individually if you only want to set up specific parts of your system.

omakos/
├── setup.sh                 # Main setup script
├── scripts/
│   ├── ascii.sh            # ASCII art for terminal output
│   ├── brew.sh             # Homebrew package installation
│   ├── cursor.sh           # Cursor editor configuration
│   ├── gemrc.sh            # Gem configuration
│   ├── ghostty.sh          # Ghostty terminal configuration
│   ├── git.sh              # Git configuration
│   ├── irbrc.sh            # IRB configuration
│   ├── mac.sh              # macOS system preferences
│   ├── mise.sh             # Mise runtime manager setup
│   ├── nvim.sh             # Neovim configuration
│   ├── rubocop.sh          # Rubocop configuration
│   ├── ssh.sh              # SSH configuration
│   ├── utils.sh            # Utility functions
│   ├── zed.sh              # Zed editor configuration
│   ├── zsh.sh              # ZSH shell setup
│   └── zshrc.sh            # Zshrc configuration
├── configs/
│   ├── Brewfile            # Homebrew packages list
│   ├── cursor/             # Cursor editor settings
│   ├── git/                # Git configuration files
│   ├── nvim/               # Neovim configuration with LazyVim
│   ├── ssh/                # SSH configuration files
│   ├── zed/                # Zed editor settings
│   ├── gemrc              # Ruby gems configuration
│   ├── ghostty.conf       # Ghostty terminal config
│   ├── irbrc              # IRB (Interactive Ruby) configuration
│   ├── mise.toml          # Mise runtime versions config
│   ├── rubocop.yml        # Ruby code style config
│   └── zshrc              # Zsh shell configuration
└── README.md

Configuration Files

The configs/ directory contains all config files.

Customization

The script is designed to be customizable. You can:

• Modify the Brewfile to add/remove packages
• Adjust macOS settings in scripts/mac.sh
• Modify the configuration files in configs/ directory

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

Inspiration and code was taken from many sources, including:

• Formation by Mina Markham
• Omakub