Build the ultimate AI/software-development workstation with Omarchy.
Install → Understand → Configure → Develop → Automate → Recover → Reproduce → Master. A complete, outcome-driven path from a bare machine to a reproducible, AI-ready Omarchy workstation — free.
Stevinator Handbook
Build the Ultimate
AI/Software-Development
Workstation with Omarchy
Volume I & II · Keybindings Cheat Sheet
What's included
The course — free
25 modules + a final capstone, written and ready to read today. No paywall, ever, for this course.
The handbook — ready now
The full Stevinator Handbook as two print-formatted PDF volumes, matching every module, free to download today.
The cheat sheet — ready now
Every keybinding taught across all 25 modules, on a dense 3-page reference — plus a browser-based Shortcut Trainer to drill them and Superkey, a desktop plugin that verifies you can do them for real.
Free downloads & tools
No email, no account. Grab what you need.
Handbook — Volume I
Modules 00–12 · PDF
Download →Handbook — Volume II
Modules 13–24 · PDF
Download →Keybindings Cheat Sheet
Every shortcut · 3-page PDF
Download →Shortcut Trainer — practice in your browser
The cheat sheet, live: search it, drill every shortcut with spaced-repetition flashcards, or race a 60-second Sprint. Progress stays on your device.
Superkey — practice on your real desktop
A free Omarchy 4 plugin. Kappy asks you to press a real shortcut, then confirms through Hyprland, tmux, or Neovim that it actually worked. Ten lessons, 70 steps, each tied to a course module. Never edits your config.
Verify your setup — for real
A small, readable, open-source script that checks your actual machine instead of a self-ticked list. Download, read it, then run it.
More from Stevinator
Follow the channel for related build videos and whatever comes next.
Follow on YouTubeThe full curriculum
Every part, every module — nothing held back for a paywall. Click any module to read it.
Part I — Build It
MOD 00From Bare Metal to a Ready Omarchy Workstation+
The complete beginner-friendly installation and first-setup path — from a blank drive to a verified, updated, known-good baseline.
Read this module →Part II — Understand It
MOD 01How Omarchy Actually Works+
The mental model before you customize anything: the config hierarchy, the CLI as a control plane, version-aware learning.
Read this module →MOD 02Linux Concepts Developers Actually Need+
A focused foundation — filesystem, users/permissions, processes/services, packages vs. runtimes, PATH, boot, Wayland/Hyprland.
Read this module →Part III — Operate It
MOD 03Master the Omarchy Desktop+
The daily workflow: the Super key, workspaces, tiling, scratchpad, clipboard/capture, system panels, keybinding discovery.
Read this module →MOD 04Terminal Mastery+
A practical terminal course: Ghostty, shell fundamentals, better CLI tools (eza, bat, rg, fd, fzf, zoxide), pipes, environment, config.
Read this module →MOD 05Tmux for Development+
Enough tmux to be productive: sessions, panes, Omarchy tmux helpers, working-directory gotchas, real developer layouts.
Read this module →Part IV — Build Software
MOD 06Development Environment Management+
A clean, reproducible toolchain: omarchy pkg vs. install vs. mise, global runtimes, project-specific versions, avoiding system pollution.
Read this module →MOD 07Git and GitHub+
The workflow developers actually need: daily Git, GitHub CLI auth, branches, worktrees for parallel AI agents.
Read this module →MOD 08Editor Integration+
Use Omarchy's editor layer effectively: default editor, a Neovim survival guide, editing config safely, swap-file recovery.
Read this module →Part V — AI-Native Development
MOD 09AI Coding Agents in Omarchy+
Selecting and launching agents, AGENTS.md, sessions, safe read-only analysis, model roles, sub-agents.
Read this module →MOD 10Building an AI Development Workflow+
Turn the machine into an actual AI workstation: daily layout, project bootstrapping, the AI+Git loop, parallel work, cost awareness.
Read this module →Part VI — Customize It
MOD 11Hyprland Configuration the Omarchy Way+
File structure, load order, monitor/input configuration, window and workspace rules, reloading safely.
Read this module →MOD 12Custom Keybindings+
Adding, replacing, and disabling shortcuts; handling hardware-specific keyboard quirks.
Read this module →MOD 13Themes, Fonts, and Visual Design+
Themes, backgrounds, fonts, text scaling, and building a custom theme from scratch.
Read this module →MOD 14Plugins, Hooks, and Automation+
Event-driven hooks, writing them safely, plugin anatomy, and the trust model for third-party code.
Read this module →Part VII — Control the System
MOD 15Audio, Bluetooth, Network, and Displays+
Switching outputs, pairing devices, network status/Wi-Fi, and display/brightness/scaling controls.
Read this module →MOD 16System Toggles and Runtime Controls+
Idle/stay-awake, night light, notification silencing, the bar, screensaver, suspend, laptop-specific toggles.
Read this module →MOD 17Defaults and XDG Integration+
Setting default browser, terminal, editor, and coding agent, and why XDG defaults matter beyond the menus.
Read this module →Part VIII — Keep It Healthy
MOD 18Updates and Maintenance+
Safe update flow, update logs, package cleanup, firmware, service health, and reading logs without panic.
Read this module →MOD 19Restart, Repair, and Recovery+
Restart-first triage, config refresh, snapshot recovery, reinstall — a real recovery decision tree.
Read this module →MOD 20Boot, Limine, UKIs, and Secure Boot+
Identifying your bootloader, the UKI/systemd-stub boot flow, Secure Boot, and boot recovery.
Read this module →Part IX — Own It
MOD 21Security and Hardening+
SSH server tradeoffs, firewall implications, FIDO2, fingerprint auth, Docker privilege warnings, secrets hygiene.
Read this module →MOD 22Reproducible Workstation Setup+
Snapshots vs. backups vs. dotfiles, what to preserve, a dotfiles Git repo, rebuilding on a new machine.
Read this module →Part X — Master It
MOD 23Troubleshooting Omarchy Like a Developer+
A dedicated troubleshooting module built from real issues: shortcuts, displays, packages, boot, logs, AI-assisted debugging.
Read this module →MOD 24Understand the Full Stack You Built+
Connect every dot: power button to desktop, keypress to application, project folder to running app, update to recovery.
Read this module →Capstone
MOD ★Build Your Own Omarchy Developer Workstation+
Starting from a clean install, produce a fully customized, reproducible, recoverable Omarchy workstation with a private dotfiles repo.
Read this module →FAQ
Is this course actually free?+
Yes — the entire course, the full Stevinator Handbook (Volumes I & II), and the keybindings cheat sheet are free. No account, no email, no paywall.
Is there a video course?+
Not currently — right now this is a free, written course you read online. If a video version happens later, it'll be linked from this page and announced on the YouTube channel.
Do I need any Linux experience?+
No. Module 0 assumes nothing — it starts from a computer that may currently run Windows and walks through installation, first boot, and a verified baseline before anything else.
Will there be paid courses later?+
Future courses may include paid, more specialized material — but this course, the Omarchy workstation build, stays free.
Can I use the handbook without doing the course?+
Yes. The handbook is a standalone, print-formatted reference (Volume I: Modules 00–12, Volume II: Modules 13–24) — read it on its own or alongside the course.
What version of Omarchy does this cover?+
Developed and tested on Omarchy 4.x (Quattro) and cross-checked against current official docs. The course teaches you to verify commands and behavior on your own install rather than hard-coding one release.