Chapters
  1. Welcome to Omarchy!
  2. Getting Started
  3. Coming From Mac or Windows
  4. Navigation
  5. The Top Bar
  6. Themes
  7. Hotkeys
  8. Unified Clipboard & History
  9. Reminders
  10. Notices
  11. Text Extraction & Dictation
  12. Screenshots & Recording
  13. Toggles, Idle & the Screensaver
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Development Tools
  19. Shell Tools
  20. Shell Functions
  21. TUIs
  22. GUIs
  23. Browsers
  24. Commercial apps/services
  25. Web Apps
  26. Gaming
  27. Filling out PDFs
  28. Windows VM
  29. Other Packages
  30. Updates
  31. Dotfiles
  32. Shell Plugins
  33. Monitors
  34. Keyboard, Mouse, Trackpad
  35. Networking
  36. System sleep
  37. Hardware authentication
  38. Fonts
  39. Backgrounds
  40. Prompt
  41. Branding
  42. Common tweaks
  43. Making your own theme
  44. Mac support
  45. Troubleshooting
  46. FAQ
  47. System snapshots
  48. Security
  49. Omarchy on...
  50. Dual Boot Install
  51. Unattended Installs

Terminal

Foot is the default terminal for Omarchy. It’s fast, lightweight, and compatible with even old computers. It does not, however, support native tabs or splits.

If you use Tmux, you may not mind, but if not, we fully support Alacritty, Ghostty, and Kitty as options as well. Pick your preference under Install > Terminal in the Omarchy menu.

You start a new terminal using Super + Return. (This binding will automatically point to whichever Terminal you’ve installed via Install > Terminal, and you can switch between installed terminals under Setup > Defaults > Terminal.)

Tmux

Tmux provides a consistent, programmable interface for panes, windows (aka tabs), and resumable sessions regardless of your terminal. It even works on remote hosts, so when you’re SSH’ing into a server, you can use the same approach.

You start a new Tmux session in a fresh terminal using Super + Alt + Return, and because Tmux is a persistent process, you can resume your session even if you close that terminal. Just hit Ctrl + Space (called the prefix key) then s to see all your active sessions.

Omarchy ships with an ergonomically-optimized Tmux configuration, which has a lot of keybindings to learn, so keep the cheatsheet handy.

Tmux layout functions

Because Tmux is programmable, we can use functions to create layouts. Omarchy ships with four different functions for common developer layouts.

tdl [agent] starts a three-way split IDE-like interface with the $EDITOR on the left, your chosen AI agent on the right (like c for opencode or cx for Claude or codex for OpenAI), and then a terminal at the bottom.

So tdl c would start this (or just ic):

tmux-tdl

You can also start a second agent with tdl c cx (opencode + claude) (or just icx):

tmux-tdl2

There’s also tds, which starts a four-way square with the editor top left, a live diff watcher top right, a terminal bottom left, and opencode bottom right.

You can also start this layout configuration for every subdirectory in the current directory using tdlm [agent], then navigate using alt + 1/2/3/4/5/...:

tmux-tdlm

Finally, you can start a swarm of agents using tsl [panes] [command]. So tsl 4 c will give you a four-way grid of opencode agents:

tmux-tsl