Kodra macOS: Ghostty, tmux, OpenCode, and Podman — One Command to Ship

One curl command. Forty tools. Zero Docker Desktop. The macOS developer environment that goes from fresh install to azd up in minutes — with Ghostty, tmux, AI coding agents, and Podman containers baked in.

Kodra macOS developer environment running Ghostty terminal with tmux — showing fastfetch system info, Kodra banner, and GitHub Copilot CLI on Apple Silicon
40+ Tools Installed
1 Command
0 Docker Desktop
M1–M4 Apple Silicon

If you develop on a Mac, you've lived the ritual. Fresh machine. Homebrew. Then thirty brew install commands, half a dozen cask installs, a fonts tap, terminal theme configuration, shell aliases, Docker Desktop licensing conversations with legal — and by the time you're done, it's Thursday.

Kodra macOS is a one-command, fully open-source developer environment bootstrapper that gets you from a bare macOS install to a fully configured, production-ready development setup in minutes. Not a dotfiles repo. Not a Brewfile. A complete development platform — terminal, containers, AI coding agents, cloud CLIs, and 40+ tools — installed, configured, and themed. Every component is open source. MIT licensed. No vendor lock-in.

What's Inside

  • Ghostty GPU-accelerated terminal with a cyberpunk theme and Nerd Fonts (open source)
  • tmux terminal multiplexer with Kodra workspace menus
  • OpenCode — open-source AI coding agent (160K+ GitHub stars) with GitHub Copilot login
  • GitHub Copilot CLI for AI-assisted shell commands
  • Podman or Colima — full container workflow, no Docker Desktop, no license fees
  • Azure CLI, azd, OpenTofu, Terraform, kubectl, Helm, k9s — the full cloud stack
  • bat, eza, ripgrep, fzf, lazygit, delta — modern open-source CLI replacements
  • Every tool is open source or source-available — MIT licensed, fully auditable

The macOS Developer Environment Problem

Every macOS developer has their setup process. Maybe it's a README in a private repo. Maybe it's a Brewfile you haven't updated since 2023. Maybe it's tribal knowledge — "install this, configure that, don't forget the font."

The problem isn't any single tool. It's the integration. Getting Ghostty to render Nerd Fonts correctly. Making tmux work with your Starship prompt. Configuring Podman's socket so docker compose still works. Wiring up GitHub Copilot in both your editor and terminal. Each tool is simple alone — together, they're a day of configuration.

Kodra macOS solves this with one line:

curl -fsSL https://kodra.macos.codetocloud.io/boot.sh | bash

Fully open source · Inspect the source · MIT License

When it finishes, you have a development environment that looks like it took a week to curate — because it did. We just did it for you.

Open Source All the Way Down

Yes, Kodra installs cloud CLIs for Azure — a hyperscaler. But the philosophy behind Kodra is unapologetically open source. Every single tool in the stack is open source or source-available. The container runtime is open source. The terminal is open source. The AI coding agent is open source. The infrastructure-as-code tools include OpenTofu — the community fork of Terraform — alongside HashiCorp's version, because choice matters.

Here's what this means in practice:

We believe the best developer tools are the ones you can inspect, fork, and contribute to. Kodra doesn't lock you into a proprietary ecosystem — it assembles the best open-source tools into a cohesive environment that happens to work beautifully with Azure, AWS, GCP, or whatever cloud you're building on.

The only proprietary elements are optional: GitHub Copilot (your choice to enable) and VS Code (source-available). If you prefer Neovim and local LLMs, Kodra has you covered there too.

Ghostty + tmux: The Terminal Layer

The terminal is where developers live. Kodra macOS doesn't just install a terminal — it builds a terminal system.

Ghostty is a GPU-accelerated terminal emulator built by Mitchell Hashimoto (of Terraform/Vagrant fame). It renders faster than iTerm2, supports ligatures and Nerd Fonts natively, and ships with a configuration format that actually makes sense. Kodra installs Ghostty with a cyberpunk-inspired dark theme — the same aesthetic you see in the hero screenshot above.

tmux turns that single terminal window into a workspace. Kodra configures tmux with sane defaults — mouse support, 256 colors, a clean status bar — and adds a workspace menu so you can jump between projects without reaching for a mouse. Split panes, detach sessions, re-attach from SSH. If you've never used tmux, this is your on-ramp. If you already use it, these are the defaults you've always wanted.

Starship replaces the default zsh prompt with a cross-shell prompt that shows git status, language versions, cloud context, and Kubernetes cluster — all at a glance. Combined with JetBrains Mono Nerd Font, every icon and glyph renders perfectly.

OpenCode: AI Coding in Your Terminal

OpenCode AI coding agent running in VS Code terminal on macOS — terminal-native AI assistant for code generation and editing
OpenCode AI — the open-source coding agent that lives in your terminal

OpenCode is an open-source AI coding agent with over 160,000 GitHub stars. It runs directly in your terminal — no browser tab, no separate app. Ask it to fix broken tests, refactor a module, or scaffold an entire service. It reads your project context, understands your LSP configuration, and makes changes in place.

What makes OpenCode particularly compelling in the Kodra stack:

Kodra installs OpenCode alongside GitHub Copilot CLI (gh copilot), giving you two AI coding assistants. Use Copilot CLI for quick shell suggestions (gh copilot suggest "find all TODO comments in src/") and OpenCode for deep, multi-file coding sessions. They complement each other — one for velocity, one for depth.

Podman: Containers Without Docker Desktop

Podman Desktop on macOS showing running containers — frontend and backend services with Kind Kubernetes cluster, all powered by Podman
Podman Desktop managing containers — frontend, backend, and a Kind Kubernetes cluster, all license-free

Docker Desktop's licensing model changed. If your company has more than 250 employees or $10M revenue, you need a paid subscription. For many teams, that's a conversation with procurement that takes longer than the actual development work.

Kodra macOS gives you a choice during installation:

Docker vs Podman — Choose Your Stack

If you want… Choose
Maximum Docker CLI compatibility Colima + Docker CLI
No Docker dependency at all Podman
Enterprise-friendly open-source stack Podman
Existing Compose-heavy workflows Colima + Docker CLI
Visual container management GUI Podman (includes Podman Desktop)
Daemonless architecture Podman

Both stacks are fully open source and license-free. No subscription, no telemetry conversations, no procurement delays. This is what open-source container tooling looks like when it's done right — same developer experience, zero licensing overhead.

Here's the part that matters for teams migrating from Docker Desktop: when you choose the Podman stack, Kodra configures DOCKER_HOST to point at Podman's socket. Your existing docker build, docker compose up, and CI scripts work unchanged. Your muscle memory stays intact. The only difference is the engine underneath — and that engine doesn't require a license.

Both stacks include container security toolingTrivy for vulnerability scanning and Dive for inspecting image layers. Security isn't an afterthought; it's installed alongside the runtime.

GitHub Copilot CLI: AI at the Shell Prompt

Kodra installs the GitHub CLI (gh) with the Copilot extension pre-configured. This gives you AI assistance directly in your shell — no editor needed.

# Explain a complex command
gh copilot explain "find . -name '*.tf' -exec grep -l 'azurerm' {} +"

# Suggest a command from natural language
gh copilot suggest "list all pods in the kube-system namespace sorted by restart count"

Combined with OpenCode and Copilot's agent capabilities, you have AI assistance at every layer of your workflow — shell, terminal agent, and editor. This is what modern developer tooling looks like.

Building your team's developer platform? We help engineering teams standardize tooling, streamline onboarding, and adopt AI-assisted workflows.

Book a Free Strategy Call

The Full Tool Stack

Kodra macOS doctor command showing health check of all installed developer tools — bat, eza, fzf, lazygit, Azure CLI, Terraform, kubectl, and more
kodra doctor — one command to verify every tool is installed and healthy

Kodra macOS installs and configures 40+ tools across five categories. Everything is managed through Homebrew and native .pkg installers — no manual downloads, no version conflicts.

CLI Tools

ToolPurpose
batCat with syntax highlighting
ezaModern ls with icons and git status
ripgrepFast recursive search (replaces grep)
fdModern find replacement
fzfFuzzy finder for files, history, and git
deltaBeautiful git diffs with syntax highlighting
lazygitGit TUI — stage, commit, rebase visually
zoxideSmart cd that learns your habits
jq / yqJSON and YAML processors
actRun GitHub Actions locally

Cloud & Infrastructure

ToolPurpose
az / azdAzure CLI + Azure Developer CLI
terraform / tofuInfrastructure as Code — HashiCorp Terraform + OpenTofu (community open-source fork)
kubectl / helmKubernetes management
k9sKubernetes TUI dashboard
ansibleRed Hat Ansible automation
ocOpenShift CLI
pwshPowerShell 7 (native .pkg install)

Developer Tools

ToolPurpose
misePolyglot runtime manager (Node, Python, Go, Rust, Java)
VS CodeEditor with Copilot + Azure extensions pre-installed
opencodeOpen-source AI coding agent
gh copilotGitHub Copilot CLI for shell assistance
neovimTerminal editor

Every tool is verified after installation with kodra doctor — a single command that checks versions, reports missing dependencies, and can auto-fix with kodra doctor --fix.

What Gets Changed on Your Mac

Transparency matters when a script modifies your system. Here's exactly what Kodra changes:

Everything is reversible with kodra uninstall, and your original dotfiles are restored from the backup.

One Command Install

curl -fsSL https://kodra.macos.codetocloud.io/boot.sh | bash

macOS 14+ · Apple Silicon recommended · ~5GB disk space · View source on GitHub

Want to inspect before running? That's encouraged:

# Download and review first
curl -fsSL https://kodra.macos.codetocloud.io/boot.sh -o boot.sh
less boot.sh
bash boot.sh

The install is interactive — you'll choose your container stack (Docker or Podman), confirm tool selections, and see progress for each component. It's idempotent: running it again skips already-installed tools.

After installation, use the kodra CLI to manage everything:

kodra doctor          # Check tool health
kodra doctor --fix    # Auto-reinstall missing tools
kodra update          # Update all tools (brew upgrade)
kodra shortcuts       # Show all aliases and key bindings
kodra fetch           # System info (fastfetch)
kodra uninstall       # Clean removal

Kodra Across Every Platform

Kodra macOS is the third variant in the Kodra family. Whether your team runs Linux workstations, Windows with WSL2, or Macs, Kodra gives them the same tools and workflow:

Feature Kodra Linux Kodra WSL Kodra macOS
OS Ubuntu 24.04 WSL2 Ubuntu macOS 14+
Package Manager apt apt Homebrew + .pkg
Terminal Ghostty Oh My Posh Ghostty + tmux + Starship
Containers Docker CE Docker CE Colima or Podman
AI Coding Copilot CLI Copilot CLI OpenCode + Copilot CLI
Architecture x86_64 / arm64 x86_64 Apple Silicon native
CI Testing ubuntu-24.04 windows-2022 macos-15 (real Apple Silicon)

Kodra macOS is tested on real Apple Silicon runners in GitHub Actions — not emulated, not virtualized. The CI pipeline runs 360+ unit tests and full integration tests on every commit.

Frequently Asked Questions

Is Kodra macOS safe to install?

Yes. Kodra is fully open source under the MIT license. The bootstrap script installs tools exclusively through Homebrew and official .pkg installers — no binaries from unknown sources. You can inspect the entire source before running it. Existing dotfiles are backed up automatically before any changes are made.

Does Kodra macOS require Docker Desktop?

No. During installation, you choose between two container stacks: the Docker stack (Colima + Docker CLI + Compose) or the Podman stack (Podman + Podman Desktop + podman-compose). Both are fully open source and license-free. Your existing docker and docker compose commands work with either stack.

Does it work on Apple Silicon?

Yes. Kodra macOS is built for Apple Silicon (M1, M2, M3, M4) and runs on macOS 14 Sonoma or later. Intel Macs are also supported. The entire toolchain runs natively on ARM64 — no Rosetta translation layer needed.

What if I already have Homebrew and some tools installed?

Kodra detects existing installations and skips them. It's idempotent — running it on a machine with tools already installed won't break anything. It will install missing tools, apply configurations, and verify everything with kodra doctor.

What is OpenCode and how does it compare to GitHub Copilot?

OpenCode is an open-source AI coding agent that runs in your terminal. It can use your GitHub Copilot subscription, ChatGPT Plus, or 75+ other LLM providers. Think of it as a terminal-native alternative to Cursor or Windsurf — your code stays local, and you choose the model. Kodra installs both OpenCode and GitHub Copilot CLI so you have AI assistance everywhere.

Get Started

Kodra macOS is free, open source, and MIT licensed. Star the repo, fork it, contribute back. We built this because every developer deserves a world-class environment on day one — not day five. And we built it open source because the best tools are the ones you can inspect, modify, and own.

# Install Kodra macOS
curl -fsSL https://kodra.macos.codetocloud.io/boot.sh | bash

# Or inspect first — we encourage it
curl -fsSL https://kodra.macos.codetocloud.io/boot.sh -o boot.sh && less boot.sh

If you find Kodra useful, share it with your team. If your organization needs help standardizing developer environments, our fractional CTO advisory can help you build a developer platform that scales — from tooling to Azure landing zones to cloud-native training.

Join the Code To Cloud Discord to connect with other developers using Kodra, share your terminal setups, and get help with configuration.

Ready to level up your dev environment?

50+ advisory engagements across Alberta & Western Canada

Kevin Evans — Fractional CTO and founder of Code To Cloud

Kevin Evans

Fractional CTO & Founder, Code To Cloud Inc.

Kevin Evans is a fractional CTO and technology advisor based in Calgary, Alberta. He builds open-source developer tools and helps startups and growing businesses across Western Canada make smart technology decisions. More about Kevin