tty7/README.md at b5beba6d80d9ceb7cdf61bf4a5aa6c8c2a44db3b

mirror of https://github.com/l0ng-ai/tty7.git synced 2026-09-21 16:02:20 +00:00

Files

T

l0ng-aiandl0ng-ai b5beba6d80 feat(release): ship a Linux AppImage alongside the tarball (#55 )

* feat(release): ship a Linux AppImage alongside the tarball

The Linux release was a bare, dynamically-linked binary built on
ubuntu-latest, so it only reliably ran on Ubuntu — Fedora/Arch users hit
missing/mismatched runtime libs. Add an AppImage that bundles the
x11/wayland/xkb/fontconfig/freetype libs so it launches across distros.

- bundle-appimage.sh: linuxdeploy populates an AppDir + deps, completions
  go beside the binary (usr/bin/completions, matching signature.rs's
  current_exe lookup), appimagetool packs it. Runs FUSE-less on CI.
- release.yml: new "Package Linux AppImage" step after the tarball,
  libfuse2/file added to the Linux deps, *.AppImage added to the upload
  list. The AppImage step avoids `rm -rf dist` so the tarball survives.
- README (en + zh): recommend the AppImage, keep the tarball as the bare
  fallback.

Note: glibc is not bundled, so ubuntu-latest still sets the glibc floor.

* fix(release): downscale AppImage icon to a resolution linuxdeploy accepts

linuxdeploy rejected the 1024x1024 app-icon.png (its valid list tops out at
512). Resize to 256x256 with ImageMagick's convert (added to the Linux apt
deps) before handing the icon to linuxdeploy.

---------

Co-authored-by: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>

2026-07-13 10:43:26 +08:00

5.1 KiB

Raw Blame History

tty7

A GPU-rendered terminal in pure Rust.

_{GPU rendering on Zed's gpui · VT core from Alacritty}

Why tty7 · Install · Features · Benchmarks · Keybindings

_{English · 简体中文}

Why tty7

Fast — about 2× the throughput of Alacritty, Ghostty, or Kitty on the same hardware (benchmarks)
A modern prompt — completion, syntax highlighting, and history search built in; no plugins to assemble
Sessions that survive — close the window or quit the app, your shells keep running; no tmux
Zero config — zsh, bash, fish, and PowerShell work out of the box

Native builds for macOS, Windows, and Linux ship with every release.

Install

Download the build for your platform from Releases:

macOS — tty7-<version>-macos-arm64.dmg (Apple Silicon) or …-x86_64.dmg (Intel); open it and drag tty7.app into Applications.
Windows — …-windows-x86_64-setup.exe (installer: Start Menu shortcut + uninstall entry), or …-windows-x86_64.zip (portable: unzip and run tty7.exe).
Linux — …-linux-x86_64.AppImage (recommended: bundles the x11/wayland libraries, so it runs on Fedora / Arch / etc. with no extra packages — chmod +x and run), or …-linux-x86_64.tar.gz (bare binary; extract and run ./tty7, needs the usual x11/wayland runtime libraries installed).

Features

At the prompt

Ghost suggestions — your history completes the whole line as you type; → to accept
Tab completion that explains — every flag and subcommand with its description, for ~100 common commands
Syntax highlighting — as you type, nothing to install
Fuzzy history search — ⌃ R shows what you ran, where, and whether it failed
History from day one — your existing shell history just works, and carries across sessions
Real line editing — selection, word motion, undo

In the window

Tabs & splits — always open in the current directory
Command palette ⌘ P · scrollback search ⌘ F
⌘-click links · desktop notifications
Eight themes · CJK / IME input

Benchmarks

All four terminals measured back-to-back on the same machine, same day, same 155×40 grid — Apple M1 Pro, macOS 26.3.1, five-run averages (2026-07-04):

	tty7	Alacritty	Ghostty	Kitty
Plaintext IO — 11 MB `cat` _{(lower = better)}	95 ms	239 ms	179 ms	185 ms
DOOM-fire frame rate _{(higher = better)}	888 fps	485 fps	552 fps	617 fps
Cold-launch memory	116 MB¹	105 MB	128 MB	130 MB

_{¹ GUI 105 MB + the persistent daemon 11 MB.}

Where the speed comes from:

The PTY is read at device speed and parsed in large batches, off the render path
Hot paths are lock-free — a big cat never waits on drawing
The daemon buffers up to 16 MiB ahead of the window before backpressure applies

Methodology (how each terminal is driven, grid fairness, known pitfalls) and one-command reproduction live in scripts/bench/ — run it yourself.

Keybindings

Keys are shown in macOS notation — on Windows and Linux, read ⌘ as Ctrl. Open Settings with ⌘ , to browse or remap them all. The essentials:


`⌘ T` · `⌘ W` · `⌘ ⇧ T`	new tab · close tab · reopen closed tab
`⌘ D` · `⌘ ⇧ D`	split right · split down
`⌘ ]` · `⌘ [`	next pane · previous pane
`⌘ ⏎` · `⌘ ⇧ ⏎`	toggle fullscreen · maximize / restore the pane
`⌘ K`	clear the screen and scrollback
`⌘ P`	command palette
`⌘ F`	search the scrollback
`⌃ R`	fuzzy-search shell history
`⌘ +` · `⌘ −` · `⌘ 0`	font size up · down · reset

The full list — and any overrides — lives in Settings → Keybindings.

_{Built on gpui and alacritty_terminal · Apache-2.0 · Discord · Changelog}

5.1 KiB Raw Blame History Unescape Escape