Show HN: OmniPTY – Opinionated terminal emulator for macOS and Linux

OmniPTY Formerly Oxide. Installed copies update themselves; see the note below. The tools you'd normally bolt onto your terminal, built in. A native terminal for macOS and Linux, written entirely in Rust. Website · Docs · Changelog · Compare · Discord If your terminal is really a terminal plus a stack of add-ons — tmux for splits and sessions, a file manager in another pane, a prompt framework, a copy-mode plugin — OmniPTY builds those in. A file tree you drive like vim sits beside your panes and follows your shell's cd. Tabs and splits group into named workspaces you can pin, so they reopen with the same layout and directories. Copy mode puts vim keys on the scrollback, and the status bar knows your git branch and when you're inside ssh. It's all configured in one TOML file that reloads when you save. Under the hood, it's GPU-rendered on GPUI (Zed's UI framework), with alacritty_terminal (Alacritty's PTY + VT parser) doing the emulation, so vim, htop, and tmux itself still just work. No account, no AI, no telemetry: the only thing OmniPTY asks the network is whether there's a newer release. Renamed from Oxide Oxide became OmniPTY in 0.9.0 (there's an unrelated company called Oxide, and the name was getting in the way). Nothing to do if you already had it installed: The in-app updater carries an installed Oxide across: it lands as OmniPTY.app with your config, themes and pinned workspaces intact. A Dock icon pinned to the old Oxide.app path needs re-adding. Homebrew: switch to the new cask with brew uninstall --cask --force oxide-terminal && brew install --cask --adopt omnipty-terminal/tap/omnipty. --adopt keeps the OmniPTY.app the updater already put in place. ~/.config/oxide/config.toml and ~/.cache/oxide are copied to omnipty directories on first launch; the originals are left alone. $OXIDE_SESSION and $OXIDE_VERSION are still exported through 0.9.x; switch dotfiles to $OMNIPTY_SESSION / $OMNIPTY_VERSION. theme = "oxide" keeps working; the palette is now also called omnipty. Install macOS brew install --cask omnipty-terminal/tap/omnipty Or download the DMG and drag OmniPTY to Applications. Builds are Developer ID signed and notarized, so there's no right-click-to-open dance, and OmniPTY keeps itself up to date afterwards — it checks on launch and every six hours, or on demand via OmniPTY → Check for Updates… Updates are signed, and OmniPTY only installs one whose signature matches the key it was built with. Linux (Wayland or X11, x86_64) # Arch and derivatives: a pacman package from the PKGBUILD in this repo # (an AUR package will follow once AUR registration reopens) git clone https://github.com/omnipty-terminal/omnipty.git cd omnipty/packaging/aur/omnipty-bin && makepkg -si # any distro: the release tarball tar xzf omnipty-linux-x86_64.tar.gz cd omnipty-*-linux-x86_64 && ./install.sh # into ~/.local, no root Download the tarball; older versions are on the releases page. install.sh puts omnipty on your PATH and adds the launcher entry and icon; --prefix /usr/local (with sudo) installs system-wide, --uninstall removes it. Installed copies announce a newer release in the top-right corner; git pull and makepkg -si again, or a fresh tarball, does the update. macOS 12 or later, Apple Silicon or Intel; or Linux with glibc 2.35 or newer (Ubuntu 22.04, Debian 12, Fedora 36 and later), a Vulkan driver (any GPU from the last decade — Mesa's vulkan-radeon / vulkan-intel, or nvidia-utils) and notify-send (libnotify) for desktop notifications. No font to install — JetBrainsMono Nerd Font Mono is bundled. Set font.family to use your own. zsh or bash for the built-in prompt and shell integration. Other shells run fine and keep their own prompt. OmniPTY never writes to your dotfiles. Full instructions are in the install docs. A closer look A minute in OmniPTY — the tree, a markdown preview, the file finder, splits, tabs, the palette and theme picker, workspaces. Features 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. Keys 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. Configuration ~/.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 Build from source 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- -linux- .tar.gz tar xzf target/omnipty-*-linux-*.tar.gz -C /tmp && /tmp/omnipty-*-linux-*/install.sh The omnipty command takes a directory, -e [args...] to run a program in the first pane instead of the shell, --app-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. Architecture 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/ /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. Known limitations 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. Community 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. License MIT — see LICENSE. OmniPTY builds on GPUI and alacritty_terminal, both Apache-2.0.