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

Files

T

l0ng-aiandl0ng-ai 64403cf860 feat(terminal): expose the prompt editor's soft newline as a rebindable InsertNewline action (#246 )

* feat(keymap): make the prompt editor's soft newline a bindable action

Shift+Enter and Opt/Alt+Enter have inserted a literal newline into the
command editor since the multi-line prompt editor landed in 54825d3, and
only a plain Enter submits. But the chords were hardcoded in the editor's
key handler, so `InsertNewline` was not a name the keymap knew: nothing to
put in `keybindings` in config.json, no row in Settings -> Keybindings, and
no way to move the gesture to a chord of your own.

Register it like every other action. `InsertNewline` is Terminal-scoped
(the handler lives on the terminal surface, as ClearScrollback and the find
trio already are) and the "enter" arm of the editor dispatcher no longer
looks at modifiers at all — the keymap dispatches the action before the key
reaches the dispatcher, so there is one implementation rather than two that
can drift.

The action ships with both of today's chords. A binding spec cannot express
alternatives — whitespace in a spec means a sequence, `ctrl-b n`-style —
and the effective table holds exactly one keystroke per action, so the
table carries shift-enter and alt-enter is installed alongside it, but only
while the action still sits on its default. Rebind it and both old chords
are retired, which is what moving a binding is supposed to mean.

The prompt editor alone answers it. With a foreground application on the
pane, the search field focused, or a completion menu / reverse search
holding the keyboard, the handler propagates, so the chord takes the exact
path it took before this action existed — a full-screen program still
receives Shift+Enter as its own chord under the Kitty protocol. Plain Enter
still submits, and the secondary-enter / secondary-shift-enter window
bindings are untouched.

Refs #182

* fix(prompt): let the newline chords through an open completion menu

Follow-up to the InsertNewline action, from review findings, resolved
against Warp as the reference implementation.

The action declined whenever a completion menu was open, on the theory
that propagating preserved the old behaviour. It did for Shift+Enter,
which used to reach the picker's accept-line arm, but not for Alt+Enter:
the picker branch is gated on `!m.alt`, so Alt+Enter skipped it entirely
and fell through to the enter arm's newline. Propagating sent it to an
enter arm that now unconditionally submits, so Alt+Enter with a menu open
ran the command.

Warp does not let the popup take these chords at all. Only a bare Enter
reaches the popup-acceptance path (a fixed "enter" binding routed into
`input_enter`, where menus and the completion popup consume it); Shift+
Enter, Alt+Enter and Ctrl+J dispatch their own actions, which the editor
resolves as a newline against `EnterSettings` without the popup ever
seeing them. Its TUI has no popup in the input's dispatch path at all.

So insert unconditionally and close the menu — a newline ends the word
being completed, and a menu still filtered on that word would be stale.
Shift+Enter with a menu open therefore changes from accept-line to
insert, deliberately and in the direction of the reference; Alt+Enter
goes back to inserting, as it did before the action landed. Plain Enter
keeps accepting the highlighted candidate.

Also repeat the dispatcher's per-key state resets (`editor_goal_col`,
`last_word_nav`), which the inline branch inherited by running inside
`handle_editor_key` and the action bypassed — the same reason
`commit_text` repeats them for the IME path.

Shift+Alt+Enter, which the old `(m.shift || m.alt)` test caught by
accident, is left submitting: gpui matches modifiers exactly, and Warp's
key table has no arm for that chord either. Recorded in a comment and a
test so it is not "restored" later as a missing default.

Refs #182

* no-mistakes(review): scope rebind's NoAction to its context; see extra chords

* no-mistakes(document): document rebindable InsertNewline chords; fix rustfmt and changelog link

---------

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

2026-07-29 01:05:08 +08:00

9.8 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; when tty7 has nothing to offer the Tab falls through to your shell's own completion, and the whole feature can be turned off (Settings → Terminal → Keyboard, or tab_completion in config.json)
Syntax highlighting — as you type, nothing to install
Fuzzy history search — ⌃ R shows what you ran, where, and whether it failed; turn it off (Settings → Terminal → Keyboard, or history_search in config.json) and ⌃ R goes to your shell instead, so an fzf / percol binding keeps working
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. ⇧ ⏎ · ⌥ ⏎ insert a newline instead of submitting (rebindable as InsertNewline); a plain ⏎ submits the whole buffer

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
⌘/Ctrl-click links (⌘ on macOS, Ctrl on Windows/Linux) · desktop notifications · copy on select (opt-in, Settings → Terminal → Clipboard)
Smart double-click selection — double-click grabs the whole URL, file path, bracket/quote pair, or dictionary-segmented CJK word under the cursor; Shift-click extends a selection (toggle in Settings → Terminal → Mouse; word separators via word_separators in config.json)
Nine themes, plus your own — YAML seed themes with solid, gradient, or image backgrounds; iTerm2 .itermcolors import; in-app color editor with a background-image picker
Sync with system — Settings → Appearance; pick separate light and dark themes and tty7 follows the OS appearance live (theme_follow_system, theme_preset_light / theme_preset_dark in config.json)
Window opacity & blur — Settings → Appearance → Window; applies to every theme, Follow theme returns to the theme's own opacity / blur
CJK / IME input

Fonts

Hack is bundled — it ships inside the binary, so the default renders identically everywhere without relying on a system install
Primary + ordered fallbacks — font_family and font_fallbacks in config.json; optional font_family_bold / font_family_italic for distinct faces, and font_features to pass OpenType features through (contextual ligatures stay off unless you ask for them)
Platform-aware defaults — the fallback list names faces the host OS actually ships (PingFang SC / Apple Color Emoji on macOS, Microsoft YaHei / Segoe UI Emoji on Windows, Noto on Linux). Those stock names are appended to a hand-written list too, so a config.json written on another platform still resolves

CJK and the two-column grid

A cell is one advance of the primary face, and a wide (CJK) character is pinned to exactly two of them. A CJK fallback therefore sits flush in its slot only if its ideographs advance twice the primary's Latin advance.

Bundled Hack advances 0.60205em, so a two-column slot is 1.2041em — while every stock CJK face (Microsoft YaHei, PingFang SC, Noto Sans CJK) advances 1.0em. Those glyphs get left-aligned in the slot and the leftover ~0.2em lands as a gap on the right of every character.

Maple Mono NF CN is tried first on every platform for exactly this reason — 0.6em Latin, 1.2em CJK, an exact two-cell fit against Hack. It is referenced by name only, never bundled (~20MB per weight): install it and tty7 picks it up with no config change.

For CJK set tight rather than merely even, change the primary face instead — one that advances 0.5em (Sarasa Mono SC, say) makes two columns exactly 1.0em.

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; Settings → Agents installs the hooks that feed it (Claude Code, Codex, Copilot CLI, OpenCode, Pi, Grok Build)
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 on restore, carrying the original launch flags (claude --dangerously-skip-permissions --resume …) (restore_agent_sessions, on by default)
Fork session — branch a live agent conversation into a second, independent one by shelling the agent's own fork command (codex fork <id>, claude --resume <id> --fork-session, also OpenCode and Grok Build); the original is untouched and both continue separately. Right-click a pane to pick a split placement, or right-click the tab / sidebar row to open the fork in a new tab. Needs the agent's hooks installed, since the fork targets the session id they report; a remote pane can't fork, because the command would run against the local agent — and note a fork copies the whole transcript, so repeated forking costs real disk in the agent's own session store
Copy Session ID — put the agent's native session id on the clipboard, beside Copy Working Directory, for pasting into codex resume, a bug report, or another tool
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 ⌘/Ctrl-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

9.8 KiB Raw Permalink Blame History Unescape Escape