{"id":25743028,"url":"https://github.com/yatish27/omakos","last_synced_at":"2025-05-09T00:53:12.579Z","repository":{"id":278134249,"uuid":"934620608","full_name":"yatish27/omakos","owner":"yatish27","description":"Opinionated macOS setup ","archived":false,"fork":false,"pushed_at":"2025-04-20T00:34:20.000Z","size":435,"stargazers_count":64,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-09T00:53:06.293Z","etag":null,"topics":["cursor","development-setup","fresh-installs","ghostty","homebrew","laptop","laptop-setup","macos","mise","ollama","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yatish27.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-18T06:11:50.000Z","updated_at":"2025-05-07T00:19:35.000Z","dependencies_parsed_at":"2025-04-19T04:21:30.335Z","dependency_job_id":"b343f7a9-85a3-403b-87a0-e7a4339a598d","html_url":"https://github.com/yatish27/omakos","commit_stats":null,"previous_names":["yatish27/omakos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yatish27%2Fomakos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yatish27%2Fomakos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yatish27%2Fomakos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yatish27%2Fomakos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yatish27","download_url":"https://codeload.github.com/yatish27/omakos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171235,"owners_count":21865289,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor","development-setup","fresh-installs","ghostty","homebrew","laptop","laptop-setup","macos","mise","ollama","zsh"],"created_at":"2025-02-26T10:18:13.802Z","updated_at":"2025-05-09T00:53:12.570Z","avatar_url":"https://github.com/yatish27.png","language":"Shell","funding_links":[],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"\u003cimg src=\"./configs/images/icon.png\" alt=\"Omakos Icon\" width=\"100\"/\u003e\n\n# Omakos\n\n\u003e Omakos turns your macOS laptop into a fully functional development machine in a single command.\n\u003e A shell script to setup a new mac.\n\nOmakos is inspired by Basecamp's [Omakub](https://github.com/basecamp/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.\n\nIt can be run multiple times on the same machine safely.\nIt installs, upgrades, or skips packages based on what is already installed on the machine.\n\n\u003cimg src=\"./configs/images/screenshot_1.png\" alt=\"screenshot\" width=\"600\"/\u003e\n\n## Install\n\nYou can install Omakos using one of these two methods:\n\n### Option 1: Direct Install (Recommended)\n\nRun this single command in your terminal:\n\n```sh\ncurl -L https://raw.githubusercontent.com/yatish27/omakos/main/install.sh | bash\n```\n\n### Option 2: Manual Install\n\nIf you prefer to review the code first:\n\n1. Download the repo:\n\n```sh\ngit clone https://github.com/yatish27/omakos.git \u0026\u0026 cd omakos\n```\n\n2. Review the scripts (please don't run scripts you don't understand):\n\n```sh\nless setup.sh\n```\n\n3. Run the setup:\n\n```sh\n./setup.sh 2\u003e\u00261 | tee ~/omakos.log\n```\n\nJust follow the prompts and you'll be fine. 👌\n\n## What it sets up\n\nThe setup process will install and configure the following tools and applications.\nAll packages are managed through Homebrew and defined in [`configs/Brewfile`](configs/Brewfile).\n\n### Command Line Tools\n\n- [XCode Command Line Tools](https://developer.apple.com/xcode/downloads/) for developer essentials\n- [Git](https://git-scm.com/) for version control\n- [Homebrew](http://brew.sh/) for managing operating system libraries\n- [ZSH](https://www.zsh.org/) with [Oh My Zsh](https://ohmyz.sh/) for a better shell experience\n- [coreutils](https://www.gnu.org/software/coreutils/) for GNU file, shell and text manipulation utilities\n- [curl](https://curl.se/) and [wget](https://www.gnu.org/software/wget/) for downloading files\n- [fzf](https://github.com/junegunn/fzf) for command-line fuzzy finding\n- [jq](https://stedolan.github.io/jq/) for JSON processing\n- [btop](https://github.com/aristocratos/btop) for system resource monitoring\n- [fastfetch](https://github.com/fastfetch-cli/fastfetch) for system information display\n\n### Development Environment\n\n- [Cursor](https://cursor.sh/) - AI-powered code editor\n- [Ghostty](https://github.com/mitchellh/ghostty) - Modern terminal emulator\n- [Docker](https://www.docker.com/) for containerization\n- [OrbStack](https://orbstack.dev/) for Docker and Linux development on macOS\n- [PostgreSQL 17](https://www.postgresql.org/) with `libpq` for database management\n- [Redis](https://redis.io/) for in-memory data store\n- [jemalloc](https://jemalloc.net/) for memory allocation\n- [vips](https://www.libvips.org/) for image processing (automatically installs configured runtimes if `~/.mise.toml` exists)\n- [Ollama](https://ollama.ai/) for local AI models\n- [Overmind](https://github.com/DarthSim/overmind) for process management\n- [Mise](https://mise.jdx.dev/) for runtime version management. The Mise configuration is present in [mise.toml](configs/mise.toml). It installs\n  - Python\n  - Ruby\n  - Rust\n  - Go\n  - Node\n- [UV](https://github.com/astral-sh/uv) for Python packaging\n- [pnpm](https://pnpm.io/) and [yarn](https://yarnpkg.com/) for Node.js package management\n\n### Productivity \u0026 Communication\n\n- [1Password](https://1password.com/)\n- [Brave Browser](https://brave.com/)\n- [Discord](https://discord.com/)\n- [iTerm2](https://iterm2.com/)\n- [Obsidian](https://obsidian.md/)\n- [Raycast](https://www.raycast.com/)\n- [Rectangle](https://rectangleapp.com/)\n- [Claude](https://claude.ai/)\n- [NetNewsWire](https://netnewswire.com/)\n- [PearCleaner](https://www.pearcleaner.com/)\n- [VLC](https://www.videolan.org/)\n- [WhatsApp](https://www.whatsapp.com/)\n- [Zoom](https://zoom.us/)\n\n### Fonts\n\n- Cascadia Code\n- Cascadia Mono\n- DM Sans\n- Fira Code\n- Hack\n- IBM Plex Mono\n- IBM Plex Sans\n- Other Nerd fonts\n\n## Features\n\n### Modular Scripts\n\nEach script in the [`scripts/`](scripts/) directory can be run independently:\n\n```sh\n# Run individual scripts\n./scripts/mac_setup.sh     # Only configure macOS settings\n./scripts/git_setup.sh     # Only setup Git configuration\n./scripts/cursor_setup.sh  # Only configure Cursor editor\n./scripts/mise.sh         # Only setup mise and install configured runtimes\n./scripts/dotfiles_setup.sh # Only setup dotfiles\n./scripts/ssh_setup.sh    # Only configure SSH settings\n```\n\nThe scripts are designed to be:\n\n- **Independent**: Each script can run on its own\n- **Idempotent**: Safe to run multiple times\n- **Configurable**: Easy to modify for your needs\n\n## Code Structure\n\nThe 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.\n\n```\nomakos/\n├── setup.sh                 # Main setup script\n├── scripts/\n│   ├── ascii.sh            # ASCII art for terminal output\n│   ├── brew.sh             # Homebrew package installation\n│   ├── cursor_setup.sh     # Cursor editor configuration\n│   ├── dotfiles_setup.sh   # Dotfiles management\n│   ├── git_setup.sh        # Git configuration\n│   ├── mac_setup.sh        # macOS system preferences\n│   ├── mise.sh             # Mise runtime manager setup\n│   ├── ssh_setup.sh        # SSH configuration\n│   ├── utils.sh            # Utility functions\n│   └── zsh_setup.sh        # ZSH shell setup\n├── configs/\n│   ├── Brewfile            # Homebrew packages list\n│   ├── cursor/             # Cursor editor settings\n│   ├── git/                # Git configuration files\n│   ├── ssh/                # SSH configuration files\n│   ├── gemrc              # Ruby gems configuration\n│   ├── ghostty.conf       # Ghostty terminal config\n│   ├── mise.toml          # Mise runtime versions config\n│   └── rubocop.yml        # Ruby code style config\n└── README.md\n```\n\n### Configuration Files\n\nThe [`configs/`](configs/) directory contains all config files.\n\n## Customization\n\nThe script is designed to be customizable. You can:\n\n- Modify the [`Brewfile`](configs/Brewfile) to add/remove packages\n- Adjust macOS settings in [`scripts/mac_setup.sh`](scripts/mac_setup.sh)\n- Modify the dotfiles in [`configs/`](configs/) directory\n\n## Contributing\n\nFeel free to submit issues and enhancement requests!\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements\n\nInspiration and code was taken from many sources, including:\n\n- [Formation](https://github.com/minamarkham/formation) by Mina Markham\n- [Omakub](https://github.com/basecamp/omakub)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyatish27%2Fomakos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyatish27%2Fomakos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyatish27%2Fomakos/lists"}