Independent Omarchy Guide
Daily workflow

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.

ChoiceGood fit
FootLightweight, stable, Tmux-centered workflow
GhosttyRicher modern terminal features
AlacrittyCross-platform and compact configuration
KittyNative 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, then s: 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:

CommandPurpose
tdl [agent]Three-way editor, agent, and terminal layout
tdsFour-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.

ActionCommon binding
Find a fileSpace Space
Search project textSpace S G
Toggle file treeSpace E
Move between windowsCtrl + W W
Previous/next bufferShift + H / Shift + L
Close bufferSpace B D
Open LazyGitSpace G G
Toggle soft wrapSpace 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

  1. Clone a test project under ~/Work.
  2. Open the directory with n.
  3. Create editor, test, and log panes in Tmux.
  4. Run project tests and build.
  5. Review every change with LazyGit or Git CLI.
  6. Restore the Tmux session after reopening the terminal.
  7. 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.

On this page