# The Missing Manual on Omarchy

You picked a desktop built around the keyboard, and then every question sends you to a browser tab, a mouse, and a different window. The Missing Manual has its own Omarchy plugin so the lookup can stay where you are: one keystroke opens the library in a window that takes its colors and fonts from your current theme, searches as you type, and opens phases you have already read even when the network is gone.

This guide installs it, teaches the keys, and says plainly what it stores and what it sends. Checked against Omarchy 4.0.4 and omarchy-tmm 0.5.0.

## Prerequisite

You need Omarchy 4 running and a terminal you can type commands into. If the terminal is new to you, read [The Terminal and Shell](/guides/the-terminal-and-shell) first. For the general picture of plugins, what they can reach and how to judge one, read [Omarchy Plugins and the Marketplace](/guides/omarchy-plugins-and-the-marketplace); this guide goes deep on one plugin instead.

## How to read this

- **In a hurry?** Do the install steps in Phase 1, then keep the key tables in Phase 2 open while you try it.
- **Careful about your data?** Go straight to "What leaves your machine" in Phase 4, and "Where your key lives" in Phase 3.
- **Want it to finally make sense?** Read in order. The mental model in Phase 1 explains why the keys in Phase 2 behave the way they do.

## The phases

1. **[What the Plugin Is and How to Install It](01-install-the-plugin.md)** - the three parts it is made of, what a marketplace listing does and does not promise, and the real commands to install, update, and remove it.
2. **[Your First Ten Minutes in the Reader](02-your-first-ten-minutes.md)** - searching, reading, quizzes, diagrams, asking questions, going offline, and the `tmm` terminal client.
3. **[Making It Yours: Themes, Hotkeys, and the Study Chat](03-making-it-yours-and-the-study-chat.md)** - theme, layout, your own hotkeys, and the bring-your-own-key study chat with exactly where your key is stored.
4. **[Where Your Data Goes, and Fixing It When It Breaks](04-where-your-data-goes-and-fixing-it.md)** - what each action sends, a symptom-to-fix card, and how to report a bug.

Building a plugin like this one is a separate skill, covered in [Building Your Own Omarchy Plugin](/guides/building-your-own-omarchy-plugin). If something on your desktop stops working and you are not sure why, [When Omarchy Breaks](/guides/when-omarchy-breaks) is the recovery guide.