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

Files

T

l0ng-ai e5ede1beb7 fix(sidebar): key repo group on first pane; document grouping

The group key now reads the first pane's cwd instead of the focused
pane's, so switching focus between splits in different repos never
relocates the row (the branch line still follows focus). Also documents
the repo-grouped sidebar and the sidebar_grouping setting in
features.md / features.zh-CN.md.

2026-07-16 18:03:31 +08:00

5.9 KiB

Raw 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
Repo-grouped sidebar — the left tab sidebar groups rows under a header per git repository, non-repo tabs in a trailing Scratch section; branch switches and in-repo cds never move a row (sidebar_grouping in config.json: repo default, none for a flat list)
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
Tray icon — a system tray / menu bar item that flips to an attention state the moment any agent needs your input; its menu lists every agent pane (brand avatar + status dot, click to reveal), switches the notification policy, and offers Quit and Stop Daemon alongside the plain session-keeping quit (show_tray_icon, on by default)

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.9 KiB Raw Blame History Unescape Escape