llms.txt
Compare with other sites' llms.txt files →# YEN - GPU-Accelerated Terminal for macOS
YEN is a GPU-accelerated terminal emulator for macOS with Metal rendering,
Apple Speech dictation, terminal-first IDE workflows, bundled developer tools,
native file/browser/Git surfaces, and privacy-focused local-first defaults.
## Key Links
- [YEN website](https://yen.chat/)
- [Documentation](https://yen.chat/docs)
- [Alternatives](https://yen.chat/alternatives)
- [Use cases](https://yen.chat/use-cases)
- [Download](https://yen.chat/download)
- [Terms & Privacy](https://yen.chat/terms)
- [Music](https://yen.chat/tunes)
- [Blog](https://blog.yen.chat/)
- [Contact](https://twitter.com/yenFTW)
## About YEN
YEN is a GPU-accelerated terminal emulator for macOS with Metal rendering and native workflow tools.
Rendering latency and frame rate depend on the Mac and workload; YEN publishes no fixed performance guarantee.
## Key Features
- GPU-accelerated rendering via Metal backend
- Command Palette (Cmd + Shift + P) — one palette surface: empty query launches YEN actions (including `Review Pull Request`, `Resolve Merge Conflicts`, `IDE: Merge Readiness`, `IDE: Agents Timeline`, `IDE: Agents Export`, `IDE: Benchmark Status`, `IDE: Run Benchmarks`, `IDE: Workspace Doctor`, `IDE: Debug Status`, `IDE: LSP Status`, `IDE: LSP Diagnostics`, `IDE: LSP Install Matrix`, `IDE: Share Status`, `IDE: Share Host (Read-Only)`, `IDE: Share Revoke`, `IDE: Devcontainer Status`, `IDE: VS Code Inventory`, `IDE: VS Code Import (Dry Run)`, and `IDE: AST Status` on macOS), non-empty query searches project actions/files/symbols/content/diagnostics/history from the active terminal context, plus user-configured terminal commands (command-palette-entry)
- IDE workflows — `yen ide doctor`, `yen ide trust status`, `yen ide debug status`, `yen ide debug tui`, `yen ide debug start`, `yen ide debug continue/next/step/out/stack/inspect`, `yen ide debug breakpoint`, `yen ide debug watch`, `yen ide debug transcript`, `yen ide debug stop`, `yen ide merge-readiness`, `yen ide benchmark`, `yen ide open`, `yen ide search`, `yen ide lsp start`, `yen ide lsp status`, `yen ide lsp diagnostics`, `yen ide lsp hover`, `yen ide lsp definition`, `yen ide lsp references`, `yen ide lsp rename`, `yen ide lsp install`, `yen ide ast status`, `yen ide ast definition`, `yen ide ast references`, `yen ide share status`, `yen ide share host`, `yen ide share join`, `yen ide share revoke`, `yen ide devcontainer`, `yen ide vscode inventory/import`, `yen ide test status`, `yen ide test run`, `yen ide format/lint/fix status`, `yen ide format/lint/fix run`, `yen ide verify status`, `yen ide verify`, `yen ide gate`, `yen ide explain` / `??`, `yen ide workflow discover`, `yen ide workflow run --native <task-id>`, `yen ide workflow`, `yen ide timeline`, `yen ide pr-review`, `yen ide pr-notify`, and `yen agents list/open/timeline/note/export/templates`, with local watch-mode parity for `test run`, `workflow run --native`, and `verify`, current-branch CI plus local build-watch summaries in `pr-notify --ci-status`, a debugger baseline over shared trust/timeline state for Python / Node / executables with managed local, SSH-backed, and tracked devcontainer execution, a terminal debugger dashboard over that same session/transcript state for source excerpts, breakpoints, watches, and recent output when they are honestly available, reusable summary/log/transcript evidence surfaced through `debug status` and `trust status`, explicit debug handoffs reused across failing test/verify steps plus review/search/diagnostic routing only when the shipped debugger can really launch that semantic target, remote-aware `ssh://...` parity for detect/doctor/trust summaries/verify status/share plus explicit remote workflow execution/trust and remote devcontainer lifecycle/status keyed by workspace identity, with tracked remote devcontainer debugger execution on that same control plane, plus a bounded source-tagged `yen agents timeline` surface (`agent:<slot>`, `human`, `supervisor`, `system`) with minimal `--tail` / `--event` / `--source` / `--kind` filtering, lightweight `yen agents note` templates plus optional `--validate-link` session/slot validation and latest-session binding for slot-only validation, PR evidence that reuses recent agent approval/handoff notes for the same workspace, one shared `evidenceStatus` vocabulary (`missing-report`, `stale-report`, `unverified`, `exported-with-gaps`) plus stable JSON schema/taxonomy fields across timeline/export/PR evidence, one shared `linkedEvidence` block for reusable `quality` / `workflow` report artifacts, merge-readiness, PR review, current-branch PR-CI, and local build-watch snapshots, explicit captured adapter path/probe/launch/fallback metadata in export/session state, workspace-keyed repo context plus shared risk summary, semantic PR-review jump targets, and redacted short-retention local agent artifacts with positive-day retention overrides plus opt-in archival, plus desktop PR review and merge-conflict workspaces on macOS launched from the command palette
- Polyglot AST fallback — `yen ide ast status|definition|references` provide parser-backed fallback for Python, JavaScript/TypeScript, Go, and Swift with explicit engine labels; Rust and Zig stay on the explicit no-fallback path until shipped
- Native Settings panel (Cmd + ,) with curated bundled themes and live preview
- Chromatic window border controls (Settings > General > Window Border): toggle, width/radius, focused/unfocused palettes or Match Theme, dashed-outline accessibility fallback, and live preview (hidden in fullscreen + quick terminal)
- Built-in speech-to-text (Option + Space) — on-device on macOS 26+; older macOS uses on-device recognition when Apple reports support; no YEN speech service; runtime fallback follows the legacy rules below
- Translate-on-Dictate (experimental, opt-in, macOS 26+) — can translate final transcript before paste with safe fallback to the original transcript on failure/timeout/unsupported pairs
- Dictation menu status shows explicit enabled/blocked state with permission recovery actions
- Native macOS integration (system fonts, colors, notifications)
- Configuration-first design (plain text config file)
- Engine shell integration supports bash, zsh, fish, elvish, and nushell; YEN command wrappers and the `y` function are supplied for bash and zsh
- Built-in file browser (Cmd + Shift + O) — terminal-native file browser with Quick Look, incremental search, fuzzy find, static bundled theme/flavor defaults, and syntax-highlighted code previews (with readable fallback for huge/minified text) plus rich media/archive previews — all bundled, no Homebrew needed
- Local Git drawer (Cmd + Shift + G) — read-only native bottom overlay for branch/upstream status, grouped staged/unstaged/untracked/conflicted changes, untracked-aware stash file lists, raw unified diffs, clear no-repo/failure notices, copy/open actions, and handoff to bundled `lazygit`
- Native browser preview — Command Palette > Browser / Browser Split (search Browser, web preview, localhost, loopback, dev server, or terminal browser), `yen web`, and optional split targeting open docs, HTTPS pages, and localhost/loopback in isolated, non-persistent WebKit; WebKit connects directly to selected sites and YEN does not receive browsing activity; stateful `yen web` commands support automatic, window, split, and focused targets, and targeted status confirms which app executable acknowledged the command; terminal link capture is default-off, explicit-activation-only, and there is no bundled browser runtime
- macOS AppleScript automation — enabled by default with `macos-applescript`, target by absolute bundle path, and script `windows`, `tabs`, `terminals`, `new window`, `new tab`, `split`, `focus`, `close`, `input text`, `send key`, `send mouse button`, `send mouse position`, `send mouse scroll`, `surface configuration`, plus terminal `pid` and `tty`; `perform action` resolves allowlisted command-catalog actions only
- Bundled CLI tools (fd, rg, fzf, zoxide, bat, jq, lazygit, delta, btop, fastfetch, yen-vidthumb, yen-pdfthumb, yen-svgthumb, resvg) plus native archive preview/extract via macOS bsdtar — `bat` is included as a standalone syntax pager CLI, while file-browser code previews use the built-in previewer; SVG previews run native-first with `resvg` fallback for `.svgz` and unsupported edge cases; `delta` is bundled as the Git diff renderer for the review baseline; pre-signed and ready without homebrew
- Splits, tabs, tab sidebar (Cmd + Shift + B), scratchpad (Cmd + Shift + J), split layout presets (Cmd + Option + 1-0), and Quick Terminal (global hotkey dropdown)
- Automatic window state restoration on every launch (splits, tabs, positions)
- Copy-on-select — enabled by default and configurable in Settings; selected text copies as plain text
- Live settings reload — most changes apply while running; background opacity requires an app restart
- Welcome message for new users with key shortcuts and getting-started tips
IDE prerequisites: language servers, debugger runtimes, `devcontainer`, `upterm` or `tmate`, and agent CLIs are separate installations.
Project execution requires the relevant trust grant; read-only status commands do not grant trust.
## Keyboard Shortcuts
- Cmd + Shift + P — Command palette (empty query launches actions; non-empty query searches project actions, files, symbols, content, diagnostics, and history)
- Cmd + , — Open Settings panel
- Option + Space (hold) — Speech-to-text dictation
- Cmd + T / Cmd + N — New tab / window
- Hold an arrow, then press Cmd + D — Split left, right, up, or down
- Cmd + D / Cmd + Shift + D — Split right / down
- Cmd + F — Find terminal text
- Cmd + Option + Arrow — Focus a split; Cmd + Shift + Enter — Toggle split zoom
- Cmd + W — Close tab/pane
- Cmd + Shift + O — Open file browser
- Cmd + Shift + P, then Browser — Open native browser preview; also findable by web preview, localhost, loopback, and dev server searches
- Cmd + Shift + P, then Browser Split — Open native browser beside the active terminal window; also findable by terminal browser and split searches
- Cmd + Shift + S — Screenshot (saves window to file and copies to clipboard)
- Cmd + Shift + B — Toggle tab sidebar (transient left tab rail or opt-in persistent docked rail)
- Cmd + Shift + G — Toggle local Git drawer (read-only bottom overlay with branch/upstream status, grouped changed files, untracked-aware stash file lists, raw diff, clear no-repo/failure notices, copy/open actions, bundled `lazygit` handoff)
- Cmd + Shift + J — Toggle scratchpad (right-side notes panel)
- Cmd + Option + 1-0 — Split layout presets (Single Pane, Three Columns, Right Stack, Bottom Stack, Quad, Eastward 1-3, Eastward 2-1, Eastward 2-3, Center Stage, Three Column Bottom)
- Ctrl + ` — Toggle Quick Terminal (global hotkey dropdown)
- Cmd + Enter — Toggle fullscreen
- Fixed shortcuts are locked in Settings > Keyboard: Cmd + ,; Option + Space; Cmd + Shift + O/S/B/G/J; Cmd + Option + 1-0
- Dictation fixed-shortcut conflicts are called out in Settings with links to System Keyboard Shortcuts
- Fixed handlers are exact-match: dictation listens to exact Option + Space; layouts listen to exact Cmd + Option + 1-0 (no extra modifiers)
## File Browser Shortcuts
Inside the file browser (Cmd + Shift + O or y command):
- h / j / k / l — Vim-style navigation (or arrow keys)
- Enter — Enter a directory or open the configured file preview; l — Enter a directory
- h — Go up a directory
- Space — Quick Look preview (macOS native)
- e — Open in $EDITOR
- g o — Open in default app
- / — Find in the current file list; z — Fuzzy find with fzf; Z — Directory jump with zoxide
- Tab — Select file (for bulk operations)
- . — Toggle hidden files
- ~ — Jump to home directory
- g r — Reveal in Finder
- ? — Show help (full shortcut list)
- q — Quit; cd to the last directory only when launched through y
## Settings Panel
Press Cmd + , to open the native Settings panel with a left sidebar, global search, Import/Export/Reset actions, and 5 tabs: General, Sounds, Workspace, Themes, and Keyboard. Configure:
- Font family and size
- Cursor style (block, bar, underline) and blink
- Background opacity
- Window Border controls (enable toggle, numeric width/radius fields, focused/unfocused palette pickers or Match Theme, live preview, Differentiate Without Color dashed-outline fallback; border hides in fullscreen and quick terminal)
- Notifications — per-service system sound and volume customization (General, Build) with a searchable picker, an Off plus 10% step volume menu, delivery modes, and focused-window sound/banner controls.
- Workspace tab: tab sidebar toggle (Cmd + Shift + B) with opt-in persistent docked mode, split labels (default-off per-pane label pill, with optional worktree naming that names a pane after the git worktree its working directory sits in, falling back to the branch), scratchpad toggle (Cmd + Shift + J), and split layout presets — 10 layouts via Cmd + Option + 1-0 (Single Pane, Three Columns, Right Stack, Bottom Stack, Quad, Eastward 1-3, Eastward 2-1, Eastward 2-3, Center Stage, Three Column Bottom) with visual previews
- Speech Permissions (Sounds tab): Accessibility, Microphone, and Speech Recognition status; Dictation includes microphone selection, fixed Option + Space disclosure, and conflict guidance. Launch at Login is under General > Startup
- Dedicated Themes tab: curated bundled themes with search and live previews
- Keyboard shortcuts — every rebindable keybind with conflict detection (macOS system shortcuts + popular apps), inline recording, search/filter
- Keyboard recorder constraints are explicit: shortcuts must include Cmd/Ctrl/Option, Esc cancels capture, and recording times out after 10 seconds
- Cmd + Q and Cmd + W can be recorded safely while recording is active
- Keyboard remaps are replacement mappings (default trigger is unbound, then new trigger is written) to prevent additive duplicate bindings
- Advanced manual keybind syntaxes (global prefixes, key tables, key sequences) are preserved when saving from Settings
- Command Palette (Cmd + Shift + P) — search and launch any YEN feature, settings tab, layout preset, window border action, desktop PR review workspace, or terminal command from one keyboard-driven interface; also supports user-configured commands via command-palette-entry in config.yen
Settings changes apply as you make them; there is no Save step and no restart required, except background opacity, which takes effect after relaunch. YEN automatically manages shell-integration-features so cursor style changes from the Settings panel take effect immediately.
## Speech-to-Text
Hold Option + Space, speak, release. Your words appear at the cursor.
- SpeechAnalyzer is on-device on macOS 26+ after language assets install; hard unavailability can select the legacy recognizer
- YEN receives no dictation audio or transcripts; no AI service or login is required
- Language support varies by the speech assets and locale available in macOS
- Offline transcription is supported on macOS 26+ after required assets are installed; on older macOS it depends on Apple's on-device support
- macOS 26+ uses SpeechAnalyzer without YEN's legacy 60-second timer; Apple can still end a session after an input, asset, or resource failure
- The legacy recognizer stops after 60 seconds, including fallback on macOS 26+; it may use Apple's service when on-device recognition is unavailable
- Supports YEN and other macOS apps with Accessibility, Microphone, and Speech Recognition granted; Secure Input and target-app behavior can block insertion
- In-app paste restores the previous clipboard when no newer copy intervenes; cross-app paste keeps the transcript for recovery because delivery cannot be confirmed
- Secure Input blocks insertion and clipboard writes
- Menu bar indicator shows when dictation is active
- Idle menu shows explicit enabled/blocked status and permission recovery actions
- Permission status is polled every four seconds; revocation stops active capture or finalization and updates the blocked state
- Enable "Launch at Login" under Settings > General > Startup to start YEN at login; macOS may require approval
- Accessibility trust prompt is user-initiated from onboarding/Settings actions
- Translate-on-Dictate is experimental, optional, and off by default (macOS 26+); if translation fails, times out, or is unsupported, YEN pastes the original transcript
## System Requirements
- macOS 13.0 (Ventura) or later
- Apple silicon or Intel Mac
- Accessibility, Microphone, and Speech Recognition permissions for dictation
## Pages
- Homepage: https://yen.chat
- Documentation: https://yen.chat/docs
- Alternatives hub: https://yen.chat/alternatives
- Use cases hub: https://yen.chat/use-cases
- Warp alternative: https://yen.chat/alternatives/warp
- Wave Terminal alternative: https://yen.chat/alternatives/wave
- iTerm2 alternative: https://yen.chat/alternatives/iterm2
- WezTerm alternative: https://yen.chat/alternatives/wezterm
- kitty alternative: https://yen.chat/alternatives/kitty
- Alacritty alternative: https://yen.chat/alternatives/alacritty
- Tabby alternative: https://yen.chat/alternatives/tabby
- Cursor alternative: https://yen.chat/alternatives/cursor
- Zed alternative: https://yen.chat/alternatives/zed
- VS Code terminal alternative: https://yen.chat/alternatives/vscode
- JetBrains AI alternative: https://yen.chat/alternatives/jetbrains-ai
- Devin Desktop alternative: https://yen.chat/alternatives/devin-desktop
- Claude Code alternative: https://yen.chat/alternatives/claude-code
- OpenAI Codex CLI alternative: https://yen.chat/alternatives/codex-cli
- macOS terminal with speech-to-text: https://yen.chat/use-cases/macos-terminal-with-speech-to-text
- Terminal with native browser preview: https://yen.chat/use-cases/terminal-with-native-browser-preview
- Terminal Git diff drawer: https://yen.chat/use-cases/terminal-git-diff-drawer
- Terminal IDE local workflows: https://yen.chat/use-cases/terminal-ide-local-workflows
- Privacy-focused terminal workflows: https://yen.chat/use-cases/privacy-focused-ai-terminal
- Fast GPU terminal for macOS: https://yen.chat/use-cases/fast-gpu-terminal-for-macos
- Terminals and Tunes: https://yen.chat/tunes
- Whitepaper PDF: https://yen.chat/whitepaper.pdf
- Blog: https://blog.yen.chat
- Terms & Privacy: https://yen.chat/terms
- Cookie Policy: https://yen.chat/terms#cookies
- Blog — Discover All-The-Things in Your Terminal: https://blog.yen.chat/p/discover-all-the-things-in-your-terminal
## Command Palette
Press Cmd + Shift + P from any terminal surface to open one palette with two modes:
- Empty query: launch app actions directly
- File Browser, Browser, Screenshot, Toggle Tab Sidebar, Toggle Scratchpad, btop, fastfetch
- Review Pull Request (repo-backed macOS terminals) opens a desktop PR review workspace for the active repository with local inline-comment and evidence staging plus explicit posting and decision actions
- Resolve Merge Conflicts (repo-backed macOS terminals) opens a desktop merge-conflict workspace for the active repository with per-hunk ours / theirs / both resolution for marker-based text conflicts, explicit confirmation, and on-disk revalidation before staging
- Quick IDE actions for `IDE: Agents Timeline`, `IDE: Agents Export`, `IDE: LSP Status`, `IDE: LSP Diagnostics`, `IDE: LSP Install Matrix`, `IDE: Share Status`, `IDE: Share Host (Read-Only)`, `IDE: Share Revoke`, `IDE: Devcontainer Status`, `IDE: VS Code Inventory`, `IDE: VS Code Import (Dry Run)`, `IDE: Format Status`, `IDE: Lint Status`, `IDE: Fix Status`, and `IDE: AST Status`
- Settings deep links (jump directly to General, Sounds, Workspace, Themes, Keyboard)
- Window Border quick actions (toggle, Match Theme, palette cycling, animation toggle, Reduce Motion)
- All 10 split layout presets (Cmd + Option + 1-0)
- Cross-window navigation (jump to any open surface)