Omarchy Workflow with Foot, Ghostty, Tmux, and LazyVim
Learn Omarchy terminal entry points, persistent Tmux sessions, development layouts, and LazyVim shortcuts, or safely switch to Ghostty, Alacritty, or Kitty.
Omarchy defaults to Foot and Neovim/LazyVim, with Tmux providing panes and persistent sessions across terminals and SSH. Learn that integrated workflow before deciding whether Ghostty, Alacritty, or Kitty solves a real need.
Terminal entry points and choices
Super + Return opens the default terminal. Super + Alt + Return starts Tmux in a new one. Foot is small and fast but has no native tabs or splits; Tmux supplies both.
Install alternatives under Install → Terminal, then select one under Setup → Defaults → Terminal. The default launcher follows that choice, so there is no need to overwrite global bindings.
| Choice | Good fit |
|---|---|
| Foot | Lightweight, stable, Tmux-centered workflow |
| Ghostty | Richer modern terminal features |
| Alacritty | Cross-platform and compact configuration |
| Kitty | Native layouts, graphics protocols, extensibility |
After switching, test fonts, complex input, clipboard, SSH, theme synchronization, and GPU rendering.
Tmux concepts
Omarchy sets the Tmux prefix to Ctrl + Space. Press the prefix, release it, and then press the command key. It is not a normal global chord.
Learn these first:
Ctrl + Space, thens: choose an existing session;- open the active Tmux cheatsheet or help;
- distinguish panes, windows, and sessions;
- before closing a terminal, confirm whether the job remains in Tmux.
The same model works remotely, but nested local and remote Tmux sessions require you to know which layer receives the prefix.
Development layout functions
The official terminal manual documents helpers:
| Command | Purpose |
|---|---|
tdl [agent] | Three-way editor, agent, and terminal layout |
tds | Four-way editor, diff, terminal, and agent layout |
tdlm [agent] | Create layouts for subdirectories |
tsl [panes] [command] | Grid of agent or command panes |
For example, tdl codex organizes editor, Codex, and terminal inside one session. An agent may execute automatically, so start in a non-critical repository and inspect the Git diff.
Everyday LazyVim actions
Super + Shift + N opens the default editor; n in a terminal is a convenience alias for opening the current directory. LazyVim uses Space as its Leader key.
| Action | Common binding |
|---|---|
| Find a file | Space Space |
| Search project text | Space S G |
| Toggle file tree | Space E |
| Move between windows | Ctrl + W W |
| Previous/next buffer | Shift + H / Shift + L |
| Close buffer | Space B D |
| Open LazyGit | Space G G |
| Toggle soft wrap | Space U W |
Current LazyVim help is authoritative. Press ? inside the file tree for contextual commands, and do not bulk-edit plugin configuration from an old screenshot.
A recoverable project routine
- Clone a test project under
~/Work. - Open the directory with
n. - Create editor, test, and log panes in Tmux.
- Run project tests and build.
- Review every change with LazyGit or Git CLI.
- Restore the Tmux session after reopening the terminal.
- Add an AI agent only after the manual workflow works.
Common conflicts
- The terminal and Hyprland claim the same chord.
- A local Tmux prefix collides with a remote Tmux session.
- An input method intercepts Leader or another key sequence.
- Missing Nerd Font glyphs appear as boxes.
- An edit to Omarchy-managed LazyVim files is replaced by an update.
Use the keyboard shortcut guide for the desktop layer and the AI Agents guide for automation boundaries.
Sources: Omarchy Terminal and Neovim.
Omarchy AI Agents with Claude Code, Codex, and Local Models
Safely launch Claude Code, OpenAI Codex, OpenCode, and other agents in Omarchy, set a default agent, inspect usage, and run local models.
Omarchy Themes and Safe Desktop Customization
Switch Omarchy themes, wallpapers, fonts, and interface styling while keeping official and custom configuration maintainable.