{"id":51078685,"url":"https://github.com/codetocloudorg/kodra-macos","last_synced_at":"2026-06-23T16:03:38.801Z","repository":{"id":355967104,"uuid":"1230436851","full_name":"codetocloudorg/kodra-macos","owner":"codetocloudorg","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-15T20:05:53.000Z","size":170,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T23:05:29.051Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/codetocloudorg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["codetocloudorg"],"custom":["https://www.codetocloud.io/sponsor","https://linktr.ee/codetocloud"]}},"created_at":"2026-05-06T02:01:56.000Z","updated_at":"2026-05-15T20:04:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codetocloudorg/kodra-macos","commit_stats":null,"previous_names":["codetocloudorg/kodra-macos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codetocloudorg/kodra-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetocloudorg%2Fkodra-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetocloudorg%2Fkodra-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetocloudorg%2Fkodra-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetocloudorg%2Fkodra-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codetocloudorg","download_url":"https://codeload.github.com/codetocloudorg/kodra-macos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetocloudorg%2Fkodra-macos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34696912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-06-23T16:03:38.118Z","updated_at":"2026-06-23T16:03:38.792Z","avatar_url":"https://github.com/codetocloudorg.png","language":"Shell","funding_links":["https://github.com/sponsors/codetocloudorg","https://www.codetocloud.io/sponsor","https://linktr.ee/codetocloud"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpre\u003e\n██╗  ██╗ ██████╗ ██████╗ ██████╗  █████╗\n██║ ██╔╝██╔═══██╗██╔══██╗██╔══██╗██╔══██╗\n█████╔╝ ██║   ██║██║  ██║██████╔╝███████║\n██╔═██╗ ██║   ██║██║  ██║██╔══██╗██╔══██║\n██║  ██╗╚██████╔╝██████╔╝██║  ██║██║  ██║\n╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝\n\u003c/pre\u003e\n\n### 🍎 macOS Edition • Apple Silicon\n\n**One-command Azure developer environment for macOS.**\u003cbr\u003e\n40+ cloud-native tools, Homebrew + native `.pkg` installs, zero config.\n\n[![macOS Lint \u0026 Unit Tests](https://github.com/codetocloudorg/kodra-macos/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/codetocloudorg/kodra-macos/actions/workflows/ci.yml)\n[![macOS Install (Apple Silicon E2E)](https://github.com/codetocloudorg/kodra-macos/actions/workflows/e2e.yml/badge.svg?branch=main)](https://github.com/codetocloudorg/kodra-macos/actions/workflows/e2e.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![macOS](https://img.shields.io/badge/macOS-Apple%20Silicon-black?logo=apple)](https://github.com/codetocloudorg/kodra-macos)\n[![Version](https://img.shields.io/badge/version-0.6.0-purple)](CHANGELOG.md)\n\n\u003c/div\u003e\n\n---\n\n## Quick Start\n\n```bash\ncurl -fsSL https://kodra.macos.codetocloud.io/boot.sh | bash\n```\n\nThat's it. From a fresh macOS to `azd up` in minutes.\n\n---\n\n## What's Included\n\n### CLI Tools\n| Tool | Purpose |\n|------|---------|\n| `bat` | Cat with syntax highlighting |\n| `btop` | System monitor |\n| `delta` | Beautiful git diffs with syntax highlighting |\n| `direnv` | Per-directory environment variables |\n| `eza` | Modern `ls` replacement |\n| `fastfetch` | System info display |\n| `fd` | Modern `find` replacement |\n| `fzf` | Fuzzy finder |\n| `gh` | GitHub CLI |\n| `gh copilot` | GitHub Copilot CLI |\n| `httpie` | Human-friendly HTTP client |\n| `jq` | JSON processor |\n| `lazygit` | Git TUI |\n| `neovim` | Terminal editor |\n| `ripgrep` | Fast grep |\n| `shellcheck` | Shell script linter |\n| `tldr` | Simplified man pages |\n| `yq` | YAML processor |\n| `zoxide` | Smart `cd` |\n| `act` | Run GitHub Actions locally |\n\n### Cloud \u0026 Infrastructure\n| Tool | Purpose |\n|------|---------|\n| `az` | Azure CLI |\n| `azd` | Azure Developer CLI |\n| `bicep` | Azure Bicep |\n| `terraform` | HashiCorp Terraform |\n| `tofu` | OpenTofu |\n| `kubectl` | Kubernetes CLI |\n| `helm` | Kubernetes package manager |\n| `k9s` | Kubernetes TUI |\n| `pwsh` | PowerShell 7 (via `.pkg`) |\n| `oc` | OpenShift CLI (Red Hat) |\n| `ansible` | Red Hat Ansible automation |\n\n### Containers (No Docker Desktop)\n| Tool | Purpose |\n|------|---------|\n| `colima` | Lightweight container runtime (replaces Docker Desktop) |\n| `docker` | Docker CLI + Compose |\n| `lazydocker` | Docker TUI |\n| `podman` | Daemonless container engine (alternative to Docker) |\n| `podman-compose` | Compose support for Podman |\n| Podman Desktop | GUI for managing containers, images, and pods |\n| `trivy` | Container \u0026 IaC security scanner |\n| `dive` | Explore container image layers |\n\n\u003e **Note:** During installation you choose either the **Docker** stack (Colima + Docker CLI + lazydocker) or the **Podman** stack (Podman + Podman Desktop + podman-compose). Both are license-free.\n\n### Terminal \u0026 Shell\n| Tool | Purpose |\n|------|---------|\n| Ghostty | GPU-accelerated terminal (Cyberpunk theme) |\n| tmux | Terminal multiplexer with Kodra workspace menu |\n| Starship | Cross-shell prompt |\n| Nerd Fonts | JetBrains Mono + Meslo |\n| zsh config | Aliases, completions, FZF integration |\n\n### Developer Tools\n| Tool | Purpose |\n|------|---------|\n| `mise` | Polyglot runtime manager (Node, Python, etc.) |\n| VS Code | Editor with Copilot + Azure extensions |\n\n### macOS Defaults\nDeveloper-optimized system settings applied via native `defaults write`:\n- Fast key repeat, disabled autocorrect\n- Dock: auto-hide, minimal, no recents\n- Finder: show extensions, hidden files, path bar\n- Dark mode with purple accent\n- Screenshots to `~/Screenshots`\n\n---\n\n## Requirements\n\n- **macOS 14 (Sonoma)** or later\n- **Apple Silicon** (M1/M2/M3/M4) recommended, Intel supported\n- ~5GB free disk space\n- Internet connection for initial install\n\n---\n\n## Usage\n\n```bash\nkodra help          # Show all commands\nkodra doctor        # Check tool health\nkodra doctor --fix  # Auto-reinstall missing tools\nkodra update        # Update all tools (brew upgrade)\nkodra cleanup       # Clean caches\nkodra defaults      # Re-apply macOS settings\nkodra shortcuts     # Show all aliases\nkodra fetch         # System info (fastfetch)\nkodra uninstall     # Remove all Kodra tools and configs\n```\n\nTo uninstall Kodra completely:\n```bash\nbash ~/.kodra/uninstall.sh\n```\nOr select **option 5** from the install menu.\n\n---\n\n## Testing\n\nTests run on **real Apple Silicon** via GitHub Actions `macos-15` runners:\n\n```bash\n# Unit tests (syntax + structure, no network)\nbash tests/unit/test-structure.sh\n\n# Integration tests (actual installs via Homebrew)\nbash tests/integration/test-install.sh\n```\n\n---\n\n## Architecture\n\n```\nkodra-macos/\n├── boot.sh                 # Bootstrap (curl | bash entry point)\n├── install.sh              # Main orchestrator\n├── uninstall.sh            # Clean removal\n├── bin/kodra               # CLI tool\n├── lib/                    # Shared libraries\n│   ├── logging.sh          # Color output helpers\n│   ├── utils.sh            # run_installer, brew_install, has_command\n│   ├── checks.sh           # macOS version, Apple Silicon checks\n│   ├── state.sh            # JSON state management\n│   ├── backup.sh           # Dotfile backup/restore\n│   ├── config.sh           # Key=value settings\n│   ├── ui.sh               # Banners, progress, spinners\n│   └── package.sh          # Homebrew package abstraction\n├── install/\n│   ├── cli-tools/          # bat, eza, fzf, gh, ripgrep, etc.\n│   ├── cloud/              # az, azd, terraform, kubectl, etc.\n│   ├── containers/         # colima, docker-cli, lazydocker, podman\n│   ├── dev-tools/          # mise, vscode\n│   ├── terminal/           # ghostty, tmux, starship, nerd-fonts, shell-config\n│   └── desktop/            # dock, finder, system defaults\n├── uninstall/              # Per-tool uninstallers\n├── migrations/             # Version migration scripts\n├── configs/\n│   └── completions/        # zsh + bash tab completions\n├── tests/\n│   ├── unit/               # Fast structural tests (360 tests)\n│   └── integration/        # Real install tests (CI)\n├── llms.txt                # LLM-friendly summary\n├── llms-full.txt           # Full LLM documentation\n└── .github/workflows/\n    ├── ci.yml              # Lint + unit tests\n    └── e2e.yml             # Full install on Apple Silicon\n```\n\n---\n\n## Comparison with Kodra Variants\n\n| Feature | [Kodra](https://github.com/codetocloudorg/kodra) | [Kodra WSL](https://github.com/codetocloudorg/kodra-wsl) | **Kodra macOS** |\n|---------|-------|-----------|-------------|\n| OS | Ubuntu 24.04 | WSL2 Ubuntu | macOS 14+ |\n| Package Manager | apt | apt | Homebrew + `.pkg` |\n| Desktop | GNOME | Windows Terminal | Native macOS |\n| Docker | Docker CE | Docker CE (no Desktop) | Colima or Podman (no Desktop) |\n| Terminal | Ghostty | Oh My Posh | Ghostty + tmux + Starship |\n| Architecture | x86_64/arm64 | x86_64 | Apple Silicon |\n| CI Runners | ubuntu-24.04 | windows-2022 | macos-15 |\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. PRs welcome.\n\n---\n\n## License\n\n[MIT](LICENSE) — A [Code To Cloud](https://codetocloud.io) Project ☁️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetocloudorg%2Fkodra-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodetocloudorg%2Fkodra-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetocloudorg%2Fkodra-macos/lists"}