Koder Kodix — OS + Desktop Environment

  • Area: infra/linux/ (RFC-003 Domain)
  • Path: infra/linux/kodix, infra/linux/shell, infra/linux/x, infra/linux/keyboard, infra/linux/kolide
  • Kind: Debian-based Linux distribution + custom desktop environment

Role in the stack

Koder Kodix is the operating system of the Koder platform — the ground floor. It is a Debian-based distribution shipping with a custom desktop environment, shell, window system and input stack, all branded and pre-configured for Koder developers and end users.

  • infra/linux/kodix — ISO build (live-build), package lists, variant overlays, hook 0060 koder-suite consumer chain (pulls each component's .deb from Flow at build time)
  • infra/linux/shell — Koder shell replacing bash
  • infra/linux/x — kompose Wayland compositor based on wlroots 0.18 (scene-graph + xdg-shell + layer-shell + screencopy + window-list IPC + input-method-v2 + text-input-v3 relay + Super+Shift+S screenshot binding)
  • infra/linux/keyboard — Koder Keyboard, Android-side GBoard-parity input method (lives under infra/linux/ for historical reasons; physically an Android product targeting Kolide phones; module is scaffold-only as of 2026-05-16)
  • infra/linux/kolide — Kolide DE: panel + dock + launcher + window-overview (GNOME Activities-style; click cards to focus via IPC) + hot-corner + quick-settings + notifications + kolide-services daemon + kolide-session launcher + /usr/bin/koder-screenshot wrapper (slurp+grim)

Koder Kodix is the OS shipped on dev notebooks, Koder-branded hardware, and target-specific images (kiosks, IoT gateways, data-center nodes).

Primary couplings

Module Relationship
infra/linux/kodix Builds the ISO, applies variant overlays, ships installer and live-build config
infra/linux/x Provides the kompose Wayland compositor shipped in the desktop variant; exposes wlr-screencopy + input-method-v2 + text-input-v3 + custom window-list IPC consumed by kolide-shell
infra/linux/kolide Provides kolide-shell (paneldocklauncheroverview), kolide-services (poweraudionetworkbluetoothportalsettings daemons), kolide-session (XDG env + compositor + services + shell startup sequence)
dev/store Supplies the optional privileged Android/Waydroid store extension overlay
`dev