mirror of https://github.com/l0ng-ai/tty7.git synced 2026-09-22 08:02:24 +00:00

Files

T

l0ng-ai 501fd4a7de docs(readme): rewrite in minimal style, reposition as terminal workbench

Slim the READMEs to an index (why / install / what's inside / benchmarks);
move feature details, keybindings, and performance notes to docs/features.md
(en + zh-CN). New tagline: a terminal workbench — shells, sessions, SSH,
coding agents. Sync the Cargo.toml description.

2026-07-16 11:45:33 +08:00

5.3 KiB

Raw Permalink Blame History

Features

_{English · 简体中文}

Input

Ghost suggestions — your history completes the whole line as you type; → to accept
Explained tab completion — 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 works as-is and carries across sessions
Line editing — click to place the caret, mouse selection, word motion, undo
Multi-line editing — wrapped and multi-line commands edit in place; the grid shifts to keep the caret visible

In the window

Tabs & splits — always open in the current directory
Command palette ⌘ P · scrollback search ⌘ F
⌘-click links · desktop notifications · copy on select (opt-in, Settings → Terminal → Clipboard)
Eight themes · CJK / IME input

Coding agents

tty7 recognizes third-party coding agents running in a pane (Claude Code, Codex, Gemini CLI, Aider, Amp, OpenCode, and ~10 more) and adds around them — it never wraps or replaces the agent.

Brand avatars — the tab chip / sidebar row shows which agent runs where; custom wrappers map in via agent_commands in config.json
Status dot — working (blue) / needs your input (amber) / done (green), driven by agent-reported events over an OSC channel; run Agent: Install Claude Code Hooks from the palette to wire Claude Code up
Notifications — "needs your permission…" the moment an agent blocks on you, and "finished after Ns" per turn, honoring your notification policy
Branch at a glance — each sidebar row shows its pane's git branch and working-tree diff (+N −M), refreshed on cd and when a command finishes
Session resume — panes lost to a reboot re-launch their agent conversation (claude --resume …) on restore (restore_agent_sessions, on by default)
Context feed — palette commands send the current selection or the repo's git diff to the running agent as a ready-made prompt

SSH

A native Rust SSH stack (russh) is the only path — profiles, credentials, and SFTP without shelling out to ssh. There is no system-ssh compat mode.

QuickConnect — type user@host[:port] in the palette and connect; IPv6 [::1]:port supported
Saved profiles — full connection config with passwords / passphrases in the OS keychain, never on disk
~/.ssh/config aliases — type one to connect (resolved natively — common fields, best-effort — over russh), or import them as profiles in Settings
GUI auth — in-pane sheets for password, key passphrase, 2FA, and host-key confirmation (new vs. changed)
Built-in SFTP — a slide-in file panel: browse, upload / download, rename / delete / chmod, drag to Finder
Port forwarding — Local / Remote / Dynamic, preconfigured or added live, plus ⌘-click localhost:PORT to auto-forward
Jump hosts & proxies — multi-hop via profile references or ProxyJump, ProxyCommand, SOCKS5 / HTTP

Entry point	Connects via
Saved profiles · QuickConnect · typed `user@host[:port]`	Native russh — SFTP · keychain · GUI auth · L/R/D forwards
`~/.ssh/config` aliases	Resolved natively, then russh (`Match`/canonicalize/GSSAPI unsupported — no fallback)

Keybindings

Keys are shown in macOS notation — on Windows and Linux, read ⌘ as Ctrl. The essentials:


`⌘ T` · `⌘ W` · `⌘ ⇧ T`	new tab · close tab · reopen closed tab
`⌘ 1`…`⌘ 9` · `⌃ ⇥` · `⌃ ⇧ ⇥`	jump to tab 1–9 · next tab · previous tab
`⌘ D` · `⌘ ⇧ D`	split right · split down
`⌘ ]` · `⌘ [`	next pane · previous pane
`⌘ ⌥ ←→↑↓`	focus the pane in that direction
`⌘ ⏎` · `⌘ ⇧ ⏎`	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

Settings → Keybindings (⌘ ,) lists every shortcut. Click one, press the new keys (Esc cancels, Backspace resets to default), and it takes effect immediately. Pane resize and swap have no default keys — bind them here or run them from the command palette.

tmux preset — remaps pane/tab actions onto a prefix (default ⌃ B): ⌃ B C opens a tab, ⌃ B % splits, ⌃ B then an arrow moves focus. A bare prefix reaches the shell after a brief pause; prefix + an unbound key passes straight through.

Performance notes

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

5.3 KiB Raw Permalink Blame History Unescape Escape