l0ng-ai 533c7d387a fix(terminal): keep pasted text out of the shell's binding table (#660)
Review follow-up on the previous commit, which sends a plain single line
raw so fish's `expand-abbr` (and every other input-time expansion) runs.
Raw delivery is not selective: it hands the line to the shell's binding
table, and printable keys live there too. Three consequences, each
reproduced on a pty.

`TerminalView::paste` inserts the clipboard straight into the editor's
buffer, so a pasted line was going out raw as well -- and bracketed
paste's contract is that what was pasted is what runs. A fish user with
`abbr -a l 'ls -la'` who pastes `l /tmp` out of their notes would have
run `ls -la /tmp`. `CmdEditor` now carries a paste mark: `insert_pasted`
sets it, `clear` -- which runs on every submit and every handoff --
resets it, and every edit in between keeps it, including the wholesale
`set` a completion or ghost suggestion does over the pasted text.
Dropping the mark there would reopen the hole; keeping it only ever
costs that one line its shell-side expansion.

`char::is_control` is the right predicate for what it rules out (a Tab
completes, a `^U` kills, a `^C` abandons) but it cannot rule out a
rebound printable key, and it should not: that is the mechanism. Typed
lines therefore do pick up whatever the user has bound. `bindkey .
rationalise-dot` turns a typed `echo a...b` into `echo a../..b`, and
zsh-autopair -- which deliberately disables itself inside a bracketed
paste -- now sees an unbalanced quote. That is the same delivery those
users already get with `prompt_editor: false`, so this makes tty7 agree
with the shell they configured instead of diverging from it, but it is a
real change and the PR names the configs.

The 512-byte bound was justified as a knee in a measurement whose timer
included the plugin sourcing. Measured properly -- prelude settled
before the timer, completion marker printed by a prelude-defined
function so it never appears in the echoed line, 11 iterations, medians
-- a paste is flat in length and raw is linear from the first byte, with
no knee anywhere. The bound is a ceiling on added submit latency, not a
discontinuity, and the comment now says so.
2026-09-07 20:08:50 +08:00
2026-09-04 17:42:08 +08:00
2026-09-04 17:42:08 +08:00
2026-09-04 17:42:08 +08:00

tty7

tty7

A terminal workbench: persistent sessions, remote work, agents.

Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty


CI Version Platforms License Discord

English · 简体中文


tty7 with a tab sidebar of agent sessions across several repos, running Claude Code

Why

A background server owns your shells and panes — not the window. Everything below follows from that.

  • Performance — ~2× the throughput of Alacritty, Ghostty, or Kitty (benchmarks)
  • Persistent sessions — quit or reboot; your shells and supported agent sessions keep running, no tmux
  • Agent-aware — Claude Code, Codex & co.: status, notifications, and git context for every repo at once
  • Scriptable by agents — one agent opens a pane for another, hands off a task, waits, and reads the result, with or without the GUI running
  • Editor-grade input — suggestions, completion, highlighting, history search, with no plugin to install
  • Remote development — files, repos, panes, and git data stay on the remote machine, over a native SSH stack
  • Git beside the terminal — source control, diffs, and worktrees without leaving the window

Install

Native builds for macOS, Windows, and Linux on Releases:

macOS …-macos-arm64.dmg · …-x86_64.dmg drag into Applications
Windows …-setup.exe · portable ….zip
Linux …-x86_64.AppImage chmod +x and run — X11/Wayland libraries bundled

What's inside

Agent-aware per-pane detection (19 CLIs) · status dot · notifications · branch + diff · tray icon when input is needed · resume after reboot · tab sidebar grouped by repository
CLI + Skills bundled tty7 CLI · agent skill · run streams a command and exits with its code · split · send · wait --until free · capture
Editor-grade input ghost suggestions from history · explained tab completion · syntax highlighting · multi-line editing · click places the caret · ⌃ R fuzzy history
Window tabs & splits · ⌘ P palette · ⌘ F scrollback search · ⌘ J panel with process tree and listening ports · 13 themes, your own YAML, iTerm2 import · IME
Shell integration injected when a pane starts, nothing to install · prompt marks · working directory · exit codes · command-finished notifications · zsh, bash, fish, PowerShell, WSL, remote panes
Remote workspaces remote files, repos, changes, diffs, worktrees, tabs, and panes · reconnect from any client and continue where you left off
SSH native russh stack: profiles with keychain secrets · SFTP panel · port forwarding · jump hosts · one-time, unprivileged tty7-server install
Git panel follows the focused pane · stage, commit, amend, branch, push, stash · side-by-side or unified diffs · commit graph with cherry-pick, revert, and reset · a new worktree opens its own tab

Supported agents

Detection is free: brand avatar, branch + diff, tab title. Status takes one click under Settings → Agents to install that agent's hook, and brings the status dot, notifications, the tray icon, tty7 wait, and resume after a reboot. Fork needs both — the agent's own fork command, and the hook that tells tty7 which session to fork.

The full support matrix, all nineteen
Agent Detected Status · resume Fork
Claude Code ✓ ✓ ✓
Codex ✓ ✓ ✓
Grok ✓ ✓ ✓
OpenCode ✓ ✓ ✓
Oh My Pi ✓ ✓ ✓
Droid ✓ ✓ ✓
Qwen Code ✓ ✓ ✓
Goose ✓ ✓ ✓
Gemini ✓ ✓
Copilot ✓ ✓
Kimi Code ✓ ✓
Pi ✓ ✓
Aider ✓
Amp ✓
Cursor ✓
Auggie ✓
Hermes ✓
Vibe ✓
Antigravity ✓

None of them are wrapped or proxied — the agent you start is the agent you get, in a normal PTY, with its own interface. An agent launched through a wrapper script can be mapped to one by name with agent_commands in config.json.

Documentation

Full documentation lives in docs/ — keyboard shortcuts · config.json · CLI reference. The agent-facing CLI interface is also documented in skills/tty7/SKILL.md.

Install the skill with:

npx skills add l0ng-ai/tty7    # install
npx skills update tty7         # update later

Benchmarks

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 I/O — 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 server 11 MB.

Methodology and one-command reproduction: scripts/bench/.


S
Description
A terminal workbench in pure Rust: shells, persistent sessions, SSH, coding agents. GPU-rendered on Zed's gpui, VT core from Alacritty.
Readme Apache-2.0
48 MiB
Languages
Rust 97.3%
TypeScript 1.4%
Shell 0.4%
CSS 0.4%
PowerShell 0.2%
Other 0.1%