Skip to content

Instantly share code, notes, and snippets.

View usrbinkat's full-sized avatar
👩‍💻

Kat Morgan usrbinkat

👩‍💻
View GitHub Profile
@usrbinkat
usrbinkat / README.md
Created April 14, 2026 18:10
Pulumi + Python + Nix

Pulumi + Python + Nix: Complete Implementation Specification

Purpose: Exhaustive implementor-level reference for building, migrating, and maintaining Pulumi Python infrastructure projects using Nix for hermetic dependency management. Replaces pip, uv, virtualenv, and pyproject.toml-based dependency resolution with a single python.withPackages derivation that is reproducible, offline-capable, and free of PATH collisions.

Audience: Any developer or AI agent with zero prior Nix, pip, uv, or Pulumi knowledge. Every concept is defined from first principles. Every code snippet is complete and

Workspace Volume Manager for macOS

A robust utility for creating and managing a persistent APFS volume mounted at /workspace on macOS systems. This tool provides automated volume provisioning, boot-time mounting, and comprehensive lifecycle management through a single command-line interface.

Version: 10.0.0
Platform: macOS 15.2+ (Sequoia)
License: MIT


@usrbinkat
usrbinkat / KONDUCTOR.md
Created December 27, 2025 17:40
What's Cookn

KONDUCTOR: Exhaustive Technical Omnibus

Executive Summary

Konductor is a Nix-based, polyglot, AI-first developer workstation distribution that produces:

  • OCI container images for ephemeral development
  • QCOW2 VM images for persistent KubeVirt/libvirt deployments
  • Nix devshells for native machine development
  • NixOS/Home Manager/nix-darwin modules for system-level integration

Building Control Planes: From Classical Patterns to Kubernetes Operators

A primer for experienced engineers approaching Kubernetes API machinery


The Mental Model Journey

Before we dive into Kubernetes specifics, let's establish what we're actually building: a control plane. Not container orchestration, not pod scheduling—those are implementation details of one particular control plane (the one that ships with Kubernetes). We're interested in the machinery itself.

@usrbinkat
usrbinkat / napkin.md
Created December 13, 2025 22:49
optiplexprime.v2

OptiPlex Prime Platform Reference Architecture v2.0

Document Scope

This document defines the reference hardware architecture for a progressive-scaling homelab cluster designed for enterprise development, machine learning, and cloud-native workloads. The architecture prioritizes used enterprise hardware for cost optimization while maintaining production-grade capabilities.

Design Principles

  1. Progressive Investment Model: Start at $300/node, scale to $3000+/node
  2. Vertical-then-Horizontal Scaling: Maximize per-node capacity before adding nodes
@usrbinkat
usrbinkat / README.md
Created November 29, 2025 19:29
Pixel 6 Pro XL Graphene OS Install Procedure
@usrbinkat
usrbinkat / read.md
Created November 15, 2025 04:35
notes

Kalilix Tmux Implementation: Complete Technical Specification

Executive Summary

This document provides production-ready specifications for implementing a declarative, Nix flake-based tmux configuration for the Kalilix project. The implementation eliminates imperative plugin management (TPM), achieves hermetic reproducibility through home-manager, and delivers a 90% solution for modern terminal-based development workflows targeting macOS, Linux, and WSL environments.

Core recommendation: Use home-manager's programs.tmux module with tmuxp for session management, vim-tmux-navigator for neovim integration, and Catppuccin Macchiato theme with samoshkin's F12 nested session pattern for remote work. This combination provides battle-tested reliability, excellent Nix integration, and minimal cognitive overhead.

Why this matters: Developers waste 5-10 minutes daily on tmux configuration inconsistencies, SSH clipboard issues, and context switching between local/remote sessions. A

@usrbinkat
usrbinkat / factory.yaml
Created November 6, 2025 01:15
dbg talos image factory
# Node 1 (cp1) - Talos Image Factory Schematic
# IP: 10.201.73.193
# Hostname: cp1
# Bond: ens1f0np0, ens1f1np1 (802.3ad LACP)
#
# This schematic configures network settings via kernel arguments so the node
# can boot with working networking in environments without DHCP.
#
# USAGE:
# 1. Upload schematic to Image Factory to get schematic ID:
@usrbinkat
usrbinkat / fedora-42-userdata.yaml
Created October 24, 2025 19:13
KubeVirt Fedora 42 Gnome xRDP VDI Demo
---
#cloud-config
hostname: fedora
fqdn: fedora.home.arpa
ssh_pwauth: true
disable_root: false
# User configuration
chpasswd:
list: |
@usrbinkat
usrbinkat / JDK.md
Last active March 1, 2026 22:17
Debian 13 Trixie - OpenJDK/Node/NPM && Linux 6.16 Kernel Install

OpenJDK, Node.js, NPM Installation - Debian Trixie 13

Requirements

  • Debian GNU/Linux 13 (trixie)
  • sudo access

Installation Steps

1. Install OpenJDK 25, Node.js, and npm