Skip to content
Semos

Attyx

Attyx is a deterministic, VT-compatible terminal emulator written in Zig. It features GPU-accelerated rendering with Metal on macOS and OpenGL on Linux — fast, correct, and configurable.

Install

Section titled “Install”

Homebrew (macOS)

Section titled “Homebrew (macOS)”
Terminal window
brew install semos-labs/tap/attyx --cask

Homebrew (Linux x86_64)

Section titled “Homebrew (Linux x86_64)”
Terminal window
brew install semos-labs/tap/attyx

On Linux, Attyx installs as a desktop application. It should appear in your app launcher automatically. If it doesn’t, log out and back in to refresh the desktop entry cache.

Build from source

Section titled “Build from source”

Requires Zig 0.15.2+.

Terminal window
zig build run

Configuration

Section titled “Configuration”

Attyx is configured via ~/.config/attyx/attyx.toml. See the configuration docs for all options, or check the included attyx.toml.example for a quick-start template.

Features

Section titled “Features”
  • Deterministic VT-compatible engine — predictable, reproducible terminal behavior
  • GPU-accelerated rendering — Metal on macOS, OpenGL on Linux
  • Full SGR support — 16, 256, and 24-bit true color
  • Scrollback buffer — configurable size with efficient memory usage
  • Mouse support — X10 and SGR mouse encoding, text selection
  • In-terminal search — incremental search with smart-case matching
  • TOML + CLI configuration — human-readable config with hot reload
  • Cross-platform — macOS and Linux
  • Unicode support — proper wide-character handling
  • Alternate screen buffer — full support for TUI applications
  • Hyperlinks — OSC 8 clickable URLs in terminal output
  • IME support — input method editor for CJK and other languages
  • Bracketed paste mode — safe pasting with shell awareness
  • Kitty graphics protocol — display images and rich visual content in the terminal
  • Kitty keyboard protocol — unambiguous key reporting with modifier keys, key release events, and full disambiguation
  • Background transparency + blur — opacity control with blur effects
  • Reflow on resize — preserves text wrapping when terminal size changes
  • Scroll regions — DECSTBM top/bottom margins for scrolling areas
  • Synchronized output — deferred rendering for smooth TUI updates
  • Session logging — bounded ring buffer of session events
  • Cursor trail — optional cursor trail effect

Next Steps

Section titled “Next Steps”

Configuration — TOML config file and hot reload

Architecture — layers, data flow, and design decisions

CLI — command-line flags

VT Compatibility — supported escape sequences

Building from Source — build, run, and test

Keybindings — rebind hotkeys and keyboard shortcuts

Custom Sequences — bind keys to raw escape sequences

Popups — floating terminal overlays

Themes — built-in and custom color schemes

Alpha

Section titled “Alpha”

Attyx is currently in alpha. Expect breaking changes as we iterate toward a stable release.