For kids 6 to 15 on Omarchy Linux

A small creature who lives on your desktop, watches what you do, and lights up when you do it.

Omi turns a child's first session on Linux into a short adventure: pick a vibe, and the whole computer changes to match. Then do six real things with the keyboard while Omi watches. When you press the keys, Omi sees it and cheers.

Install with one command Source on GitHub

Free and open source (MIT). No accounts, no network, no tracking.

Omi's picker open over an Omarchy desktop: six vibe cards, a Cosmic Horizon preview with its palette, a name field reading Sam, and a checked box for painting the whole desktop.
The whole tour in under a minute. Silent, so watch it anywhere.

Pick a vibe. Try one on this page.

Six looks. Choosing one in Omi repaints the wallpaper, the bar, the terminal, and the window borders on the real desktop. Undo is one click.

Why Omi exists

The first computer a kid really gets to call their own shapes how they think computers work for a long time. Omarchy is a fast, beautiful, keyboard-first Linux desktop, but it assumes you already know that Super + Space opens the menu and that windows tile themselves. A six-year-old does not know that. A fifteen-year-old will not read a manual to find out.

Omi never explains at you. It asks you to do the thing, then proves it noticed. The goal is that a child walks away believing Linux is theirs, not that it is hard.

How it works

  1. The Omi vibe picker with six theme cards, a live preview, a name field, and the checkbox Paint my whole desktop too.

    1. Say hi, pick a vibe

    Omi introduces itself and asks your name (optional). Tap a card to try it on; Omi changes outfit to match. English and Spanish.

  2. The compact quest card for Jump to another room.

    2. The desktop transforms

    Confirm, and the picker dissolves while the real desktop recolors underneath. Omi flies to a corner as a small card that never blocks anything.

  3. The same quest card in Spanish: Abre el menu, Super + Espacio.

    3. Do six real things

    Each quest shows one real shortcut as keycaps. Omi listens to the desktop and reacts the instant you do it. Next always works too.

  4. The explorer card: That's the tour, Sam, six stamps, and buttons Play again and Off you go.

    4. Earn your explorer card

    Stamps for every quest, a star when Omi saw it, and exactly how to find Omi again. Then Omi gets out of the way.

The six quests

Every key is a stock Omarchy binding, verified by the test suite against the installed defaults.

QuestYou doOmi sees
Open the menuSuper + Space, then close itthe menu open, then close
Open a windowSuper + Entera window appear
Jump to another roomSuper + 2, then Super + 1two workspaces visited
Close a windowSuper + Wa window close
Hide the barSuper + Shift + Space, twicethe bar vanish and return
One more? (optional)Super + KSuper + Ctrl + ESuper + Ctrl + Spacea shortcut sheet, emoji picker, or wallpaper menu open

Omi only says "I saw that" when it really did. If a signal is missing, the quest still completes with I did it or Next; it just gets a check instead of a star.

Small things that matter

Never in the way

During quests the card takes no keyboard focus and accepts clicks only on itself. Every shortcut you are learning keeps working. Drag it to any corner or click Omi to shrink it to just the face.

A face that looks

Omi's eyes follow your pointer, glance up at the bar when the lesson is about the bar, blink at their own pace, and step aside when the menu opens.

Reversible

Desktop painting is a checkbox. "Put my old look back" restores exactly the theme you had. Everything Omi writes lives in your home folder and is listed in the README.

Quiet

Three soft sound cues, never more than one a second, never over a fullscreen window, mutable. A calm-motion mode follows your Hyprland animation setting.

Truthful

The previous version taught "tap the Super key", which does nothing on Omarchy. Now every shortcut on screen is tested against the shipped keybindings.

Findable

After the tour Omi is one search away: Super + Space, type Omi. It also appears in the Apps menu.

For parents and teachers

  • No network, no accounts, no telemetry. Omi never connects to anything. The child's name is stored only in a local config file and is never logged.
  • No privileges. Omi runs as the signed-in user and never asks for a password.
  • Everything it writes is in the home folder and documented, with the exact undo for each item, in the README.
  • Reading level is about an independent 8-year-old's; older kids get the same respect, no baby talk.
  • Open source. Read every line at github.com/DailenG/omi. Security boundaries are spelled out in SECURITY.md.

Install

On any Omarchy machine:

omarchy plugin add https://github.com/DailenG/omi.git --enable
~/.config/omarchy/plugins/dailen.omi/bin/omi

To greet a new user automatically on their first login:

omarchy hook install post-boot ~/.config/omarchy/plugins/dailen.omi/scripts/first-run-check.sh

Remove

omarchy plugin remove dailen.omi
omarchy theme set <your previous theme>      # if you let Omi paint the desktop
rm -rf ~/.config/omarchy/themes/omi-* ~/.config/omi
sed -i '/"learn.omi": /d' ~/.config/omarchy/extensions/omarchy-menu.jsonc
rm -f ~/.local/share/applications/omi.desktop

Requires Omarchy with the Quickshell shell and Hyprland. Desktop painting uses Omarchy's own omarchy-theme-set and rsvg-convert; sounds use PipeWire's pw-play. Each is optional and skipped quietly if missing.