v0.5.3 — Ubuntu Desktop edition

v0.7.1 — WSL2 edition

agentic-first

wsl2-native

v0.1.0 — macOS edition

apple-silicon

██╗  ██╗ ██████╗ ██████╗ ██████╗  █████╗ 
██║ ██╔╝██╔═══██╗██╔══██╗██╔══██╗██╔══██╗
█████╔╝ ██║   ██║██║  ██║██████╔╝███████║
██╔═██╗ ██║   ██║██║  ██║██╔══██╗██╔══██║
██║  ██╗╚██████╔╝██████╔╝██║  ██║██║  ██║
╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝

Agentic Azure
Engineering

Powered by GitHub CLI and agentic AI. Cloud-native tools, AI assistance, and a beautiful desktop—all configured with one command. From fresh Ubuntu to azd up in minutes.

Powered by GitHub CLI and agentic AI. Cloud-native tools, AI assistance, and a polished WSL2 Ubuntu workflow—all configured with one command inside Windows Terminal.

Powered by GitHub CLI and agentic AI. Cloud-native tools, AI assistance, and a beautiful terminal—all configured with one command on your Mac.

Get Started View on GitHub

40+ tools

~15 min setup

43 tests passing

MIT license

25+ Tools

~10 min Setup

WSL2 Native

MIT License

30+ Tools

~10 min Setup

Apple Silicon

MIT License

bash — kodra install bash — kodra install bash — kodra install

$ wget -qO- https://kodra.codetocloud.io/boot.sh | bash

✓ Azure CLI + azd installed
✓ Docker CE configured
✓ VS Code + Tokyo Night theme
✓ GitHub Copilot ready
✓ Desktop themed

Done in 4m 32s — Run kodra doctor to verify

$ wget -qO- https://kodra.wsl.codetocloud.io/boot.sh | bash

✓ WSL systemd verified
✓ Docker CE auto-start enabled
✓ Azure CLI + azd installed
✓ Oh My Posh + Nerd Font ready
✓ GitHub Copilot CLI configured

Done in 3m 58s — Run kodra doctor --fix if anything needs repair

$ curl -fsSL https://raw.githubusercontent.com/codetocloudorg/kodra-macos/main/install.sh | bash

✓ Homebrew packages installed
✓ Azure CLI + azd configured
✓ Colima + Docker CLI ready
✓ Ghostty + Starship prompt set up
✓ VS Code extensions installed

Done in 5m 12s — Your Mac is ready to ship

See it in action

Beautiful developer environment

Desktop

bat • eza • btop • lazygit

Desktop Manager

GNOME • Blur my Shell • Dash to Dock

Terminal

Ghostty • fastfetch • Starship

Tokyo Night theme • Nerd Fonts • 40+ cloud-native tools pre-configured

See it in action

WSL2-native developer environment

kodra doctor

$ kodra doctor ✓ systemd active ✓ docker service healthy ✓ windows terminal font linked ✓ kubectl / helm / k9s ready

kodra help

$ kodra help doctor verify WSL setup repair fix shell and services update refresh tooling fetch show environment info version print installed version

kodra repair --all

$ kodra repair --all ✓ shell profile restored ✓ docker auto-start refreshed ✓ oh-my-posh config applied ✓ windows integration re-linked

Windows Terminal • Docker CE native • Oh My Posh • zero Docker Desktop license required

See it in action

macOS developer environment

kodra doctor

$ kodra doctor ✓ homebrew healthy ✓ colima + docker running ✓ ghostty + starship configured ✓ kubectl / helm / k9s ready

kodra help

$ kodra help doctor verify macOS setup update refresh tooling fetch show environment info version print installed version help show available commands

kodra fetch

$ kodra fetch ✓ macOS 14+ (Apple Silicon) ✓ ghostty terminal active ✓ starship prompt loaded ✓ azure cli authenticated

Ghostty • Starship • Colima + Docker CLI • no Docker Desktop required

Why Ubuntu?

We chose Ubuntu as our foundation because it offers the best balance of stability, community support, and developer experience. With millions of users and extensive documentation, you'll never be stuck on a problem for long.

Massive Community 40M+ users, endless tutorials, instant answers on Stack Overflow

Lower Learning Curve Most beginner-friendly Linux distro with polished desktop experience

Azure Native Support First-class support in Azure VMs, WSL, and all major cloud tools

LTS Stability 5 years of security updates, no surprise breakages mid-project

Supported

Ubuntu 24.04+

Noble Numbat LTS

WSL Edition now available — switch view

All CLI tools, Azure integrations, and GitHub Copilot running in Windows Terminal. Preview the WSL2 edition →

WSL2 Native

Built for WSL2

Designed for Windows developers who want a clean Ubuntu workflow without Docker Desktop licensing or manual shell surgery.

⚙️ WSL Systemd

Bootstraps and validates systemd so services behave like real Ubuntu instead of a fragile shell shim.

🐳 Docker CE Auto-Start

Uses native Docker CE inside WSL2 and configures auto-start, avoiding Docker Desktop licensing complexity.

🔤 Windows Terminal Fonts

Sets up Nerd Font-friendly prompts that render correctly in Windows Terminal and VS Code terminals.

✨ Oh My Posh

Provides a polished shell prompt optimized for WSL2 sessions, cloud tooling, and git-heavy workflows.

💙 PowerShell 7

Installs PowerShell 7 alongside Ubuntu tooling so cross-platform scripting feels natural on the same machine.

🪟 Windows Integration

Plays nicely with code ., explorer.exe ., and Windows-native workflows from your Linux shell.

Apple Silicon Native

Built for macOS

Designed for Mac developers who want a polished Azure cloud workflow with native tooling and zero Docker Desktop overhead.

🍺 Homebrew Native

Every tool installed through Homebrew or native .pkg installers. Clean, predictable, and easy to maintain.

🐳 Colima + Docker CLI

Run containers with Colima backing the Docker CLI. No Docker Desktop license, no background daemon bloat.

👻 Ghostty Terminal

GPU-accelerated terminal built for macOS with native rendering, Starship prompt, and Nerd Fonts.

🔧 mise Runtime Manager

Manage Node, Python, Go, and other runtimes with mise. Fast, polyglot, and shell-agnostic.

⚡ Apple Silicon

Optimized for M-series chips. ARM-native builds for all tools, no Rosetta translation overhead.

🎨 macOS Defaults

Sensible Dock, Finder, and keyboard tweaks. Dark mode, fast key repeat, screenshots folder, and more.

Features

Everything you need to ship

From Bicep templates to Kubernetes deployments—with AI suggesting your next move.

☁️

Azure-Native

Azure CLI, azd, Bicep, Terraform, and PowerShell 7—all configured and ready to deploy.

🐙

GitHub CLI Native

The gh CLI is central to your workflow—PRs, issues, repos, and CI/CD from the terminal.

🤖

Agentic AI

GitHub Copilot CLI powers agentic workflows. Type ?? to ask AI anything from your terminal.

🐳

Container-Ready

Docker CE, lazydocker TUI, and Dev Containers for reproducible environments.

☸️

Kubernetes

kubectl, Helm, and k9s for managing AKS clusters with style.

⚡

Modern Terminal

Ghostty terminal with Starship prompt and Nerd Fonts. Fast and beautiful.

⌨️

50+ Shortcuts

Shell aliases for Git, Docker, Azure, and Terraform plus desktop shortcuts for faster flow.

🎨

Themed Desktop

ULauncher, window tiling, system monitor, blur effects, wallpapers, and a clean dock.

🏢

Enterprise CI/CD

GitHub Actions, Azure DevOps, and release workflows sit naturally beside your local toolchain.

🛡️

Security Scanning

Container, IaC, and dependency scanning tools help you catch issues before they ship.

Features

A WSL2-native cloud workstation

Lean, Windows-friendly, and optimized for Azure, containers, and fast terminal-driven development.

☁️

Cloud & Azure

Azure CLI, azd, Bicep, Terraform, and OpenTofu ready inside your WSL2 Ubuntu environment.

🐳

Containers

Docker CE runs natively in WSL2—no Docker Desktop dependency, no extra license overhead.

🤖

AI-Powered

GitHub Copilot CLI and GitHub CLI make agentic workflows feel at home in Windows Terminal.

💠

Terminal

Oh My Posh, Nerd Fonts, and modern CLI tools give WSL2 a polished, productive shell experience.

🧰

Dev Tools

VS Code integration, fonts, git tooling, and shell helpers are configured for daily use.

🛡️

Security

Built to avoid Docker Desktop license requirements while still delivering secure container workflows.

Features

A macOS-native cloud workstation

Homebrew-powered, Apple Silicon optimized, and ready for Azure, containers, and fast terminal-driven development.

☁️

Cloud & Azure

Azure CLI, azd, Bicep, Terraform, and OpenTofu ready on your Mac via Homebrew.

🐳

Containers

Colima backs the Docker CLI natively—no Docker Desktop required, no licensing headaches.

🐙

GitHub CLI

The gh CLI with Copilot for PRs, issues, repos, and AI-powered terminal commands.

☸️

Kubernetes

kubectl, Helm, and k9s for managing AKS clusters from your Mac.

⚡

Modern Terminal

Ghostty terminal with Starship prompt and Nerd Fonts. GPU-accelerated and beautiful.

🔧

Runtime Manager

mise manages Node, Python, Go, and other runtimes. Fast, polyglot, and version-pinned.

🤖

Agentic AI

GitHub Copilot CLI powers agentic workflows. Type ?? to ask AI anything from your terminal.

🏢

Enterprise CI/CD

GitHub Actions and Azure DevOps workflows sit naturally beside your local Mac toolchain.

Batteries Included

The complete toolkit

Cloud-native and desktop tools that are configured to work together.

🖥️

Ghostty

📝

VS Code

☁️

Azure CLI

🚀

azd

💪

Bicep

🏗️

Terraform

🐳

Docker

☸️

kubectl

⎈

Helm

🐙

k9s

🐱

GitHub CLI

🤖

Copilot

🦇

bat

📂

eza

🔍

fzf

🔎

ripgrep

📊

btop

⚡

Starship

Batteries Included

WSL2-ready tools

A focused cloud toolkit for Windows developers who prefer Linux shells.

☁️

Azure CLI

🚀

azd

💪

Bicep

🏗️

Terraform

🧱

OpenTofu

🐳

Docker CE

☸️

kubectl

⎈

Helm

🐙

k9s

🧭

lazydocker

✨

Oh My Posh

🔍

fzf

🌿

lazygit

📍

zoxide

📂

eza

🦇

bat

📊

btop

🛰️

fastfetch

🐱

GitHub CLI

🤖

Copilot CLI

CLI

One command interface

Manage your desktop, themes, and cloud setup with simple commands.

kodra themeSwitch between themes

kodra wallpaperBrowse and set wallpapers

kodra desktopConfigure dock, tiling, login

kodra dockSet dock favorite apps

kodra setupRe-run first-time setup

kodra doctorCheck system health

kodra doctor --fixAuto-fix common issues

kodra updateUpdate all tools

kodra fetchShow system info

CLI

WSL2 commands that keep things healthy

Focus on verification, repair, and quick access to the tools you need every day.

kodra doctorCheck systemd, Docker, fonts, and shell state

kodra doctor --fixFix the most common WSL setup issues

kodra updateRefresh packages and cloud tools

kodra repairRepair shell configuration and services

kodra repair --allRun the full repair workflow

kodra setupRe-run guided first-time setup

kodra fetchPrint environment and system info

kodra versionShow installed WSL edition version

kodra helpList all supported commands

CLI

macOS commands to keep things smooth

Verify, update, and manage your cloud dev environment from the terminal.

kodra doctorCheck Homebrew, Docker, fonts, and shell state

kodra updateRefresh packages and cloud tools via Homebrew

kodra fetchPrint environment and system info

kodra versionShow installed macOS edition version

kodra helpList all supported commands

Productivity

50+ built-in shortcuts

Shell aliases and keybindings to supercharge your workflow.

??Ask GitHub Copilot for shell commands

lgLaunch lazygit TUI

lzdLaunch lazydocker TUI

gs, ga, gc, gpGit status, add, commit, push

azd-upDeploy to Azure with azd

tf, tfi, tfp, tfaTerraform shortcuts

Super + SpaceApp launcher (Ulauncher)

Super + TWindow tiling grid

View Full Cheat Sheet

Productivity

WSL2 shortcut packs

Detailed alias bundles for the commands you reach for most when building from Windows.

�� Git

Stage, review, and commit without leaving the terminal.

gs   git status
ga   git add
gc   git commit
gp   git push
lg   lazygit

🐳 Docker

Inspect containers and jump into the TUI quickly.

dps    docker ps
dcu    docker compose up -d
dlogs  docker logs -f
lzd    lazydocker

☸️ Kubernetes

Cluster visibility without typing the long forms every time.

k      kubectl
kgp    kubectl get pods
kgs    kubectl get svc
kctx   kubectx

☁️ Azure

Fast access to auth, subscriptions, and azd deployment flows.

azl      az login
azs      az account set
azd-up   azd up
azd-down azd down

📍 Navigation

Move across projects and common folders faster.

..    cd ..
...   cd ../..
z     zoxide jump
zi    interactive zoxide

🪟 WSL Interop

Bridge Windows apps and Linux workflows in one place.

code .
explorer.exe .
pwsh
clip.exe < file.txt

Productivity

macOS shortcut packs

Shell aliases to supercharge your cloud development workflow.

??Ask GitHub Copilot for shell commands

lgLaunch lazygit TUI

lzdLaunch lazydocker TUI

gs, ga, gc, gpGit status, add, commit, push

azd-upDeploy to Azure with azd

tf, tfi, tfp, tfaTerraform shortcuts

Themes

Six beautiful themes

Cohesive color schemes across terminal, editor, and desktop.

$ azd up

🌃 Tokyo Night

Purple-blue Tokyo city lights

$ kubectl get pods

💙 Ghostty Blue

Deep navy with electric cyan

$ gh pr status

🩷 Catppuccin

Soft pastels with cozy contrast

$ terraform plan

🌄 Gruvbox

Warm retro tones for long coding sessions

$ docker ps

❄️ Nord

Cool blues with crisp contrast

$ kodra theme

🌹 Rose Pine

Muted mauves with elegant warmth

Simple Setup

How It Works

Three steps from fresh Ubuntu to productive Azure development.

1️⃣

Run One Command

Copy the install command and paste it into your terminal. Kodra handles everything automatically.

wget -qO- https://kodra.codetocloud.io/boot.sh | bash

2️⃣

Pick Your Theme

Choose from 6 beautiful themes. The installer applies colors across terminal, VS Code, and desktop.

3️⃣

Start Building

Open a new terminal and you're ready. Azure CLI, Docker, kubectl, GitHub CLI—all configured.

✓ Ready in ~15 minutes

Simple Setup

How It Works

Three steps from PowerShell to a productive WSL2 Ubuntu cloud workstation.

1️⃣

Open PowerShell → Run Command

Start from Windows, launch your WSL distro, and run the one-line installer.

wget -qO- https://kodra.wsl.codetocloud.io/boot.sh | bash

2️⃣

Tools Install Automatically

Kodra configures Docker CE, Oh My Posh, Azure tooling, and Windows-friendly shell integration.

✓ Finished in ~10 minutes

3️⃣

Verify → Start Building

Run kodra doctor, confirm services are healthy, then start shipping from the same shell.

$ kodra doctor

Simple Setup

How It Works

Three steps from fresh Mac to productive Azure development.

1️⃣

Open Terminal → Run Command

Open Terminal.app and run the one-line installer. Kodra handles Homebrew and everything else.

curl -fsSL https://raw.githubusercontent.com/codetocloudorg/kodra-macos/main/install.sh | bash

2️⃣

Tools Install Automatically

Kodra installs Ghostty, Starship, Azure tools, Colima + Docker, and configures macOS defaults.

✓ Finished in ~10 minutes

3️⃣

Open Ghostty → Start Building

Launch Ghostty, run kodra doctor, confirm everything is healthy, and start shipping.

$ kodra doctor

Questions

Frequently Asked

What Ubuntu versions are supported?+

Kodra is designed for Ubuntu 24.04 LTS and newer. It also works on Ubuntu in WSL2 for Windows users. Ubuntu 22.04 may work but is not officially supported.

Is an Azure subscription required?+

No. Kodra installs the Azure tools, but you can use them with any subscription or skip Azure-heavy workflows entirely. Docker, Kubernetes, and terminal features work standalone.

Will it break my existing setup?+

Kodra backs up your existing dotfiles before making changes. You can restore them anytime with kodra restore.

Can I customize what gets installed?+

Yes. The installer includes optional components and a minimal mode so you can tailor the environment for your workflow.

How do I uninstall Kodra?+

Run kodra uninstall for interactive removal and the option to restore original dotfiles.

Is it free and open source?+

Yes. Kodra is completely free under the MIT license, and the code is available on GitHub.

Will it break my WSL setup?+

Kodra WSL is designed to layer onto an existing Ubuntu distro safely. It focuses on shell, service, and tooling configuration rather than replacing your distro.

Can I customize it?+

Yes. You can re-run setup, tweak prompt configuration, and selectively enable or repair pieces of the environment over time.

Does it require Docker Desktop?+

No. The WSL2 edition is built around native Docker CE inside your Linux environment, so Docker Desktop is optional rather than required.

What Windows versions are supported?+

Use a Windows version with modern WSL2 support and an Ubuntu distro that can run systemd. Current Windows 11 setups are the smoothest path.

How is this different from full Kodra?+

The Ubuntu Desktop edition themes the full graphical workstation. The WSL2 edition focuses on native Linux tooling, services, and Windows Terminal integration.

Is it free?+

Yes. The WSL2 edition is also MIT licensed and free to use.

What macOS versions are supported?+

Kodra macOS requires macOS 14 (Sonoma) or newer on Apple Silicon (M1/M2/M3/M4). Intel Macs are not officially supported.

Does it require Docker Desktop?+

No. Kodra macOS uses Colima to back the Docker CLI with a lightweight Linux VM. Docker Desktop is not needed and not installed.

Will it change my macOS settings?+

Kodra applies sensible macOS defaults like dark mode, fast key repeat, and Dock tweaks. These are common developer preferences and can be reverted.

How is this different from Kodra Ubuntu?+

The Ubuntu edition themes the full Linux desktop with GNOME extensions. The macOS edition focuses on terminal tooling, Homebrew packages, and macOS-native configuration.

Is it free and open source?+

Yes. Kodra macOS is completely free under the MIT license, and the code is available on GitHub.

Agentic Azure Engineering

Beautiful developer environment

WSL2-native developer environment

macOS developer environment

Why Ubuntu?

Built for WSL2

⚙️ WSL Systemd

🐳 Docker CE Auto-Start

🔤 Windows Terminal Fonts

✨ Oh My Posh

💙 PowerShell 7

🪟 Windows Integration

Built for macOS

🍺 Homebrew Native

🐳 Colima + Docker CLI

👻 Ghostty Terminal

🔧 mise Runtime Manager

⚡ Apple Silicon

🎨 macOS Defaults

Everything you need to ship

Azure-Native

GitHub CLI Native

Agentic AI

Container-Ready

Kubernetes

Modern Terminal

50+ Shortcuts

Themed Desktop

Enterprise CI/CD

Security Scanning

A WSL2-native cloud workstation

Cloud & Azure

Containers

AI-Powered

Terminal

Dev Tools

Security

A macOS-native cloud workstation

Cloud & Azure

Containers

GitHub CLI

Kubernetes

Modern Terminal

Runtime Manager

Agentic AI

Enterprise CI/CD

The complete toolkit

WSL2-ready tools

One command interface

WSL2 commands that keep things healthy

macOS commands to keep things smooth

50+ built-in shortcuts

WSL2 shortcut packs

�� Git

🐳 Docker

☸️ Kubernetes

☁️ Azure

📍 Navigation

🪟 WSL Interop

macOS shortcut packs

Six beautiful themes

🌃 Tokyo Night

💙 Ghostty Blue

🩷 Catppuccin

🌄 Gruvbox

❄️ Nord

🌹 Rose Pine

How It Works

Run One Command

Pick Your Theme

Start Building

How It Works

Open PowerShell → Run Command

Tools Install Automatically

Verify → Start Building

How It Works

Open Terminal → Run Command

Tools Install Automatically

Open Ghostty → Start Building

Frequently Asked

Agentic Azure
Engineering