The short tour. Every feature has a page in the docs.

• Real terminal — full VT emulation via Alacritty's parser: truecolor, wide glyphs and combining marks, bracketed paste, mouse reporting (SGR), alternate-screen scrolling, OSC 8 hyperlinks, OSC 52 clipboard. vim, htop, and tmux just work.
• Inline images — the kitty graphics protocol, iTerm2's, and sixel: kitten icat, imgcat, img2sixel, yazi's previews, snacks.nvim. A picture lives in the scrollback like text does — it scrolls, reflows, and clears — and is drawn at the display's real resolution. Unicode placeholders carry images through tmux.
• File tree drawer — follows the focused pane, so switching splits re-roots it to that shell's directory. Modeless vim navigation (j/k/gg/G, nvim-tree style h/l), type-to-filter with /, and file operations: a add, r rename, m move, d delete (to Trash) — or drag a row onto a directory to move it there; the tree scrolls when the drag nears its top or bottom, and the empty strip under the rows is the root. Drag the drawer's edge to resize it, double-click it to go back to tree.width. Dims gitignored files, watches the filesystem, and follows the shell's cd automatically.
• The tree/terminal seam — y inserts the selected path at the prompt, quoted and relative; cmd-click a path:line:col in output to open it in $EDITOR at that line (nvim, VS Code, emacs, Sublime, Helix dialects built in); rows are coloured by git status; cmd-p fuzzy-finds any file under the root; cmd-shift-r reveals the shell's directory; right-click a row to re-root, copy, rename, move, delete, or reveal in Finder / your file manager — a directory, the root's name, or the empty space under the rows to add a file or folder there — or, on a .md file, preview it (P from the keyboard) rendered in a new tab or split (markdown.preview_in; full CommonMark and GitHub markdown, with tables and highlighted code with click-to-copy); enter on a picture shows it in a tab or split of its own (images.preview_in), any key to close; drag rows or drop files onto a pane. A file opened while the pane is busy in an editor gets a tab or split of its own (editor.open_in).
• Scrollback search — cmd-f, live, ⏎/⇧⏎ to walk matches; regex, case-sensitive, and whole-word toggles as clickable chips (cmd-alt-r / c / w), and a malformed regex says so instead of matching nothing.
• Copy mode — ctrl-w [ (or cmd-shift-v) turns the scrollback into a vim buffer: hjkl, w b e, 0 ^ $, gg G, ctrl-d/u, counts like 5j, / and ? search with n/N, v / V / ctrl-v visual selection, y to yank and leave. Nothing typed reaches the shell until you esc.
• Prompt jumping — cmd-↑/cmd-↓ hop between previous prompts in scrollback.
• SSH awareness — OmniPTY watches the foreground process: an ssh shows ssh: host in the status bar, and [[ssh.hosts]] patterns give a host an accent colour on the pane border so a production box is visibly red. The process name also titles the tab (vim, cargo, ssh prod-web).
• Command awareness — the shell integration's OSC 133 markers are read straight off the PTY, so OmniPTY knows what's running, how long it took, and whether it failed: elapsed time in the status bar, activity dots on tabs, a red flash on a background pane that failed, a failure gutter you can click to jump to the command, and desktop notifications for long or failed commands in panes you aren't watching (click to focus the pane).
• Command history — cmd-r searches every command run in any pane, with its directory and exit status; ⏎ inserts it at the prompt, ⌘⏎ runs it. cmd-shift-c copies the last command's output.
• Status bar — workspace, current tab (number or name, status_bar.tab), cwd plus git branch, dirty state, and ahead/behind, rendered natively.
• Configurable prompt (optional) — compile a powerline prompt from TOML segments (cwd, git, exit_status, time, duration, …), injected without touching your dotfiles (ZDOTDIR shim for zsh, --init-file for bash), with OSC 133 semantic prompt markers. Or set prompt.enabled = false and keep your starship/p10k prompt as-is.
• Themes — catppuccin-mocha, catppuccin-latte, gruvbox-dark, tokyonight, dracula, nord, solarized-dark, and omnipty (rust-toned, naturally), plus the Omarchy set: kanagawa, everforest, osaka-jade, matte-black, hackerman, rose-pine-dawn, and a dozen more — 25 presets in all. Any color individually overridable, including selection_fg. follow_system = true switches between a dark and a light preset with the system appearance (macOS, or the desktop's dark/light preference on Linux). Config reloads live.
• Split panes — split in any direction and nest freely; navigation moves by what's on screen, and exit or ctrl-w q closes a pane and reclaims its space. Drag a divider or use ctrl-w < > - + = to resize. tmux reflexes: ctrl-w z zooms a pane to the full tab, ctrl-w b broadcasts typing to every pane in the tab (with a red border and a loud status-bar pill), ctrl-w o closes the others, ctrl-w x swaps with the neighbour. window.inactive_pane_opacity dims the panes you aren't in.
• Command palette — cmd-shift-p lists every action with its binding, fuzzy-searchable. Every text field edits like the rest of the system: opt-←/→ by word, opt-delete a word back, cmd-←/→ to the ends (ctrl on Linux).
• Menus on Linux — a ☰ button in the top-left corner holds the same OmniPTY / File / Edit / View / Window / Help menus macOS puts in the menu bar, shortcuts included (app::menu opens it from the keyboard).
• Configurable keys — a [keymap] table in config.toml rebinds anything; typos get a toast with a suggestion, and a bare key that would steal from your shell is refused.
• Toasts, not dialogs — config errors, update problems, and other notices land as toasts in the bottom-right corner; click or × to dismiss. The first launch after an update shows one that opens the changelog in a new tab.
• Tabs — a Zed-style in-app tab bar, so tabs work everywhere (including under tiling window managers). cmd-t opens one in the current directory or ~/ (window.new_tab_directory); cmd-1..9 jump straight to a tab. Double-click or ctrl-w , to rename one (names survive with pinned workspaces), drag tabs to reorder, cmd-shift-t reopens the last closed one. Each tab carries its number (tabs.show_numbers), and the whole bar can be hidden — View → Toggle Tab Bar, or tabs.enabled = false — with the status bar still showing which tab you're on. Closing a workspace's last tab closes the workspace, or with tabs.close_last = "new_tab" leaves it a fresh tab in your home directory.
• Workspaces — named sets of tabs and splits, tmux-session style, managed from the drawer below the file tree (a add, r rename, d or a row's × delete, p pin, drag to reorder); cmd-alt-1..9 jump straight to one. Temporary by default; pinned ones survive restarts, restoring layout, tabs, splits, and each pane's directory with fresh shells.
• Startup commands — the tmuxinator move: give a pane a command (ctrl-w r, prefilled with the last thing that ran there) and a pinned workspace re-runs it on restore, once that pane's shell is actually at a prompt. on exit per pane: back to the shell, close the pane, or restart with backoff (and a breaker after five quick exits). e in the workspaces panel edits every pane's command at once; --no-startup-commands or shift at launch restores the layout without running any.
• The details — window size/position persistence, cmd-click to open URLs, a mouse selection that scrolls the view when dragged to the pane's top or bottom, copy-on-select option, font size at runtime (cmd +/-/0), configurable bell, a [cursor] section (block / bar / underline, blink rate, unfocused look — and vim's per-mode DECSCUSR shapes are honoured), a font fallback list for CJK and emoji, a "2,340 lines above" pill while scrolled up, cmd-k to clear scrollback, and optional dimming of the whole window when another app is frontmost.

The everyday ones. The full keymap lists every action id, and a [keymap] table in your config rebinds any of them.

The ctrl-w chords are the same everywhere. Where macOS uses cmd, Linux uses ctrl-shift (the usual terminal convention — plain ctrl-c stays the shell's) and alt-1..9 for tabs, because Super belongs to the window manager.

~/.config/omnipty/config.toml — a fully commented default is generated on first run. Font, colors, keys, and notifications apply live; [shell] and [prompt] apply to new sessions. Every option, with defaults →

[font]
family = "JetBrainsMono Nerd Font Mono"
size   = 14.0

[colors]
preset = "omnipty"              # or override any color individually
follow_system = true          # ...or switch between preset_dark / preset_light with the system
preset_light  = "catppuccin-latte"

[cursor]
style = "bar"                 # block | bar | underline

[window]
new_tab_directory = "pwd"     # pwd | home
inactive_pane_opacity = 0.8   # dim the panes you aren't in

[[ssh.hosts]]
match  = "*.prod.example.com" # red border while ssh'd into prod
accent = "#f38ba8"

[tree]
follow_cwd = true             # tree re-roots when the shell cd's
open_on_startup = true        # false starts with the drawer hidden (cmd-b shows it)

[editor]
open_in = "tab"               # tab | split — where a file opens when the pane is busy

[markdown]
preview_in = "tab"            # tab | split — where a markdown preview opens

[images]
enabled      = true           # draw the images programs send (kitty, iTerm2, sixel)
memory_limit = 128            # MB of decoded images per pane
preview_in   = "tab"          # tab | split — where a picture opened from the tree is shown

[status_bar]
enabled  = true
position = "bottom"
tab      = "number"           # number | name — the current-tab chip

[tabs]
enabled      = true           # false hides the tab bar
show_numbers = true           # small position number on each tab
close_last   = "workspace"    # workspace | new_tab — what closing the last tab leaves

[prompt]
enabled = false               # keep your own prompt (starship, p10k, ...)

[keymap]
"cmd-j" = "pane::split_down"  # keystroke = "action id"; "" unbinds

You'll need Rust (2024 edition). On macOS, also full Xcode with the Metal toolchain — GPUI compiles Metal shaders at build time:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -downloadComponent MetalToolchain   # if the build asks for it

On Linux, the GPUI build dependencies (Arch shown; Debian/Ubuntu equivalents are in .github/workflows/ci.yml):

sudo pacman -S --needed base-devel fontconfig freetype2 libxkbcommon libxkbcommon-x11 \
  libxcb wayland vulkan-icd-loader libnotify

git clone https://github.com/omnipty-terminal/omnipty.git
cd omnipty
cargo run                     # development

# macOS
./scripts/bundle.sh           # release build -> target/OmniPTY.app (ad-hoc signed)
cp -R target/OmniPTY.app /Applications/
sudo cp scripts/omnipty-cli /usr/local/bin/omnipty && sudo chmod +x /usr/local/bin/omnipty   # optional `omnipty [dir]` shim

# Linux
./scripts/linux-package.sh    # release build -> target/omnipty-<version>-linux-<arch>.tar.gz
tar xzf target/omnipty-*-linux-*.tar.gz -C /tmp && /tmp/omnipty-*-linux-*/install.sh

The omnipty command takes a directory, -e <command> [args...] to run a program in the first pane instead of the shell, --app-id <id> for the window's Wayland app-id / X11 class, and --no-startup-commands. The first two are what xdg-terminal-exec passes, and the .desktop entry declares them, so on Linux OmniPTY can be the default terminal: on Omarchy, put omnipty.desktop first in ~/.config/xdg-terminals.list.

The first build compiles GPUI — expect several minutes. A cargo run binary is a debug build: fine for poking at a change, but a full-screen program like nvim will feel sluggish in it (an unoptimised GPUI redraw doesn't fit in a 60 Hz frame; the release build uses a quarter of the CPU). It also never checks for updates, and on macOS it isn't an app bundle, so its notifications can't be clicked. Use scripts/bundle.sh / scripts/linux-package.sh for the real thing. Cutting a release is covered in RELEASING.md.

One binary crate. The PTY reader/parser runs on its own thread (alacritty_terminal's event loop) and mutates a shared Term behind a mutex; the GPUI main thread briefly locks it during paint to copy the visible grid out, then shapes and paints batched text runs directly — no per-cell elements. An image is text as far as the grid is concerned — placeholder cells written where the picture goes, each naming its slice — so scrollback, reflow, and clears need no special cases; the pixels are decoded on the background pool and drawn under the text. Directory scans, git queries, and file watching run on the background pool. The tree follows cd by polling the PTY's foreground process group cwd (tcgetpgrp + proc_pidinfo on macOS, /proc/<pid>/cwd on Linux), so it works with zero shell cooperation. Platform differences are confined to a handful of cfg sites: the process lookups, notifications (UNUserNotificationCenter / notify-send), the updater, the keymap tables, and the window chrome.

• No IME / dead-key composition yet (two-stroke accents, CJK input).
• Narrowing a pane past the width of a multi-line bash prompt can scroll the prompt's first line into scrollback until the next prompt is drawn (enter brings it back).
• Pinned workspaces restore layout and directories with fresh shells; running programs can't survive a full quit (tmux only manages it because its server never exits). Startup commands are the workaround: declare what a pane runs and it's re-run on restore. on_exit needs shell integration with zsh or bash; other shells get the command typed in and nothing more.
• Images: no animation yet (a GIF shows its first frame), and an image is part of the text grid rather than a layer over it, so text printed across one replaces that part of it and kitty's z index is ignored. The kitty protocol's file and shared-memory transfers are refused; programs fall back to sending the pixels down the pipe.
• Left/right Option can't be distinguished; option_as_meta treats left/right as both.
• Linux: there's no in-place self-update (the pill opens the release page); window.titlebar is ignored — the compositor owns decorations, and under a compositor without server-side decorations (GNOME) the window has none.

Questions, ideas, or just want to see what's coming? Join the OmniPTY Discord. Bugs and feature requests go in issues — Help → Report an Issue in the menu bar (the ☰ menu on Linux), or Report an Issue in the command palette, goes to the same place. Wondering how OmniPTY stacks up against iTerm2, Ghostty, kitty, WezTerm, Alacritty, or Warp? There's an honest comparison.

If OmniPTY earns a place in your dock, you can sponsor it on GitHub or buy me a coffee.

MIT — see LICENSE.

OmniPTY builds on GPUI and alacritty_terminal, both Apache-2.0.