mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-10-28 08:55:06 +08:00
l0ng-ai
22132631eb
* fix: shell history, config ZDOTDIR, keymap hot-reload and window close - A ZDOTDIR set in config `env` no longer replaces the zsh integration redirector; it is handed to it as TTY7_USER_ZDOTDIR instead. - Shell integration reports the shell's HISTFILE to `<config>/shell-histfiles`, so ⌃R and GUI history find history kept outside $HOME/.zsh_history. - The config watcher watches the canonical config dir: FSEvents reports resolved paths, so a dir reached through a symlink (/tmp) never matched and `keybindings` edits were not picked up. - ⌘↩ in the ⌃R menu runs the selected line instead of toggling full screen. - Close Window (shells keep running) gets ⇧⌘W on macOS and a File menu entry. * fix: keep the newest reported histfiles; bind the menu's run to cmd-enter - shell-histfiles is append-only and panes starting together append the same path; reading the first 32 lines let stale or duplicate entries hide every path reported later. Keep the newest 32 distinct ones. - secondary-enter is ctrl-enter off macOS, where the Ctrl+R menu only accepts on that chord. Bind cmd-enter, matching the menu's own key handler on every platform.
138 lines
6.5 KiB
Plaintext
138 lines
6.5 KiB
Plaintext
---
|
||
title: "Keyboard shortcuts"
|
||
description: "Every default binding, plus the action names for rebinding."
|
||
---
|
||
|
||
**Settings → Keyboard & Mouse → Keyboard shortcuts** (<kbd>⌘ ,</kbd>) is the live version of this page —
|
||
it shows what *your* copy is bound to. This is the shipped default.
|
||
|
||
## Tabs and workspaces
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| New Tab | <kbd>⌘ T</kbd> | <kbd>Ctrl ⇧ T</kbd> |
|
||
| Close Pane / Tab | <kbd>⌘ W</kbd> | <kbd>Ctrl ⇧ W</kbd> |
|
||
| Reopen Closed Tab | <kbd>⌘ ⇧ T</kbd> | <kbd>Alt ⇧ T</kbd> |
|
||
| Next Tab · Previous Tab | <kbd>⌘ ⇧ ]</kbd> · <kbd>⌘ ⇧ [</kbd> | <kbd>Ctrl PgDn</kbd> · <kbd>Ctrl PgUp</kbd> |
|
||
| Recent Tab Switcher (hold to browse, release to pick) | <kbd>⌃ ⇥</kbd> · <kbd>⌃ ⇧ ⇥</kbd> | same |
|
||
| Go to Tab 1–9 | <kbd>⌘ 1</kbd>…<kbd>⌘ 9</kbd> | <kbd>Alt 1</kbd>…<kbd>Alt 9</kbd> |
|
||
| New Workspace | <kbd>⌘ ⇧ N</kbd> | <kbd>Ctrl ⇧ N</kbd> |
|
||
| Switch Workspace | <kbd>⌘ ⇧ O</kbd> | <kbd>Ctrl ⇧ O</kbd> |
|
||
| New Window | <kbd>⌘ N</kbd> | — |
|
||
| New Agent Tab | <kbd>⌘ ⇧ A</kbd> | — |
|
||
| Go to Next Agent Needing Attention | <kbd>⌘ ⇧ U</kbd> | <kbd>Ctrl ⇧ U</kbd> |
|
||
|
||
## Panes
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| Split Right | <kbd>⌘ D</kbd> | <kbd>Ctrl ⇧ D</kbd> |
|
||
| Split Down | <kbd>⌘ ⇧ D</kbd> | <kbd>Ctrl Alt ⇧ D</kbd> |
|
||
| Next Pane · Previous Pane | <kbd>⌘ ]</kbd> · <kbd>⌘ [</kbd> | <kbd>Ctrl ⇧ ]</kbd> · <kbd>Ctrl ⇧ [</kbd> |
|
||
| Focus Pane Left / Right / Up / Down | <kbd>⌘ ⌥ ←→↑↓</kbd> | <kbd>Alt ←→↑↓</kbd> |
|
||
| Zoom Pane | <kbd>⌘ ⇧ ⏎</kbd> | <kbd>Ctrl ⇧ ⏎</kbd> |
|
||
| Enter Full Screen | <kbd>⌘ ⏎</kbd> | <kbd>F11</kbd> |
|
||
|
||
## View
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| Search Everywhere | <kbd>⌘ P</kbd> | <kbd>Ctrl ⇧ P</kbd> |
|
||
| Toggle Left Sidebar | <kbd>⌘ B</kbd> | <kbd>Ctrl ⇧ B</kbd> |
|
||
| Toggle Right Panel | <kbd>⌘ J</kbd> | <kbd>Ctrl ⇧ J</kbd> |
|
||
| Toggle Code Panel | <kbd>⌘ ⇧ E</kbd> | <kbd>Ctrl ⇧ E</kbd> |
|
||
| Font Size Up · Down · Reset | <kbd>⌘ +</kbd> · <kbd>⌘ −</kbd> · <kbd>⌘ 0</kbd> | <kbd>Ctrl +</kbd> · <kbd>Ctrl −</kbd> · <kbd>Ctrl 0</kbd> |
|
||
| Zoom the font | <kbd>⌘</kbd> + wheel | <kbd>Ctrl</kbd> + wheel |
|
||
|
||
## Terminal
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| Find in Terminal | <kbd>⌘ F</kbd> | <kbd>Ctrl ⇧ F</kbd> |
|
||
| Find Next · Previous | <kbd>⌘ G</kbd> · <kbd>⌘ ⇧ G</kbd> | <kbd>F3</kbd> · <kbd>⇧ F3</kbd> |
|
||
| Clear Scrollback | <kbd>⌘ K</kbd> | <kbd>Ctrl ⇧ K</kbd> |
|
||
| Copy · Paste | <kbd>⌘ C</kbd> · <kbd>⌘ V</kbd> | <kbd>Ctrl ⇧ C</kbd> · <kbd>Ctrl ⇧ V</kbd> · <kbd>⇧ Insert</kbd> |
|
||
| Insert Newline (at the prompt) | <kbd>⇧ ⏎</kbd> · <kbd>⌥ ⏎</kbd> | same |
|
||
| Fuzzy history search | <kbd>⌃ R</kbd> | same |
|
||
| Accept ghost suggestion | <kbd>→</kbd> | same |
|
||
| Completion menu | <kbd>⇥</kbd> | same |
|
||
|
||
On Windows and Linux plain <kbd>Ctrl V</kbd> also pastes at a shell prompt.
|
||
Inside a full-screen application — vim, less, tmux — it is passed through as
|
||
the key, so it means what the application says it means (blockwise Visual mode
|
||
in vim); paste there with <kbd>Ctrl ⇧ V</kbd> or <kbd>⇧ Insert</kbd>.
|
||
|
||
That convenience is the **Paste (outside full-screen apps)** binding, and it is
|
||
yours to move. Clearing it hands <kbd>Ctrl V</kbd> to the shell everywhere,
|
||
including readline's `quoted-insert`:
|
||
|
||
```json
|
||
{ "keybindings": { "AlternatePaste": "" } }
|
||
```
|
||
|
||
Putting Paste itself on the chord goes the other way, pasting on every screen
|
||
the way Windows Terminal does out of the box:
|
||
|
||
```json
|
||
{ "keybindings": { "PasteText": "ctrl-v" } }
|
||
```
|
||
|
||
Every <kbd>Ctrl</kbd> chord that stands for a control code reaches the program
|
||
you are running: <kbd>Ctrl 6</kbd> and <kbd>Ctrl ⇧ 6</kbd> are `^^` (vim's
|
||
alternate file), <kbd>Ctrl /</kbd> and <kbd>Ctrl ⇧ −</kbd> are `^_` (readline's
|
||
undo), <kbd>Ctrl 3</kbd> is Escape. The plain <kbd>Ctrl</kbd> chords tty7 keeps
|
||
are the ones that stand for nothing: <kbd>Ctrl ⇥</kbd> for the next tab, and on
|
||
Windows and Linux <kbd>Ctrl +</kbd> · <kbd>Ctrl −</kbd> · <kbd>Ctrl 0</kbd> for
|
||
the font size.
|
||
|
||
## Git and SSH
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| Commit (caret in the message box) | <kbd>⌘ ⏎</kbd> | <kbd>Ctrl ⏎</kbd> |
|
||
| Save (in the editor) | <kbd>⌘ S</kbd> | <kbd>Ctrl S</kbd> |
|
||
| Restart SSH Session | <kbd>⌘ ⇧ R</kbd> | <kbd>Ctrl ⇧ R</kbd> |
|
||
|
||
## Application
|
||
|
||
| Action | macOS | Windows / Linux |
|
||
|---|---|---|
|
||
| Settings | <kbd>⌘ ,</kbd> | <kbd>Ctrl ,</kbd> |
|
||
| Keyboard Shortcuts | <kbd>⌘ /</kbd> | — |
|
||
| Close Window (shells keep running) | <kbd>⌘ ⇧ W</kbd> | — |
|
||
| Hide tty7 · Hide Others · Minimize | <kbd>⌘ H</kbd> · <kbd>⌘ ⌥ H</kbd> · <kbd>⌘ M</kbd> | — |
|
||
| Quit | <kbd>⌘ Q</kbd> | <kbd>Ctrl ⇧ Q</kbd> |
|
||
|
||
## Actions with no default key
|
||
|
||
All of these are in Search Everywhere, and all are bindable under **Settings →
|
||
Keybindings**:
|
||
|
||
| Group | Actions |
|
||
|---|---|
|
||
| Tabs | `RenameTab` · `NewWorktreeTab` · `MoveTabLeft` · `MoveTabRight` · `CloseOtherTabs` · `CloseTabsToTheRight` · `CopyWorkingDirectory` · `MarkTabUnread` · `HibernateTab` · `ToggleTabSidebar` |
|
||
| Panes | `ResizePaneLeft/Right/Up/Down` · `SwapPaneNext` · `SwapPanePrev` |
|
||
| Workspaces | `SelectWorkspace1`…`SelectWorkspace9` · `RenameWorkspace` · `StopWorkspace` · `DeleteWorkspace` |
|
||
| Agents | `ForkAgentSession` (+ `Right` / `Left` / `Down` / `Up`) · `CopyAgentSessionId` · `LaunchAgent:<slug>` (one per agent, e.g. `LaunchAgent:claude`) |
|
||
| Git | `ScmStageAll` · `ScmUnstageAll` · `ScmDiscardAll` · `ScmCommitAmend` · `ScmRefresh` · `ScmSync` · `ScmPush` · `ScmPull` · `ScmFetch` · `ScmCheckoutBranch` · `ScmCreateBranch` · `ScmToggleGraph` · `ToggleDiffViewMode` |
|
||
| Panels | `ShowRightPanelInfo` · `ShowRightPanelFiles` · `ShowRightPanelSearch` · `ShowRightPanelChanges` · `ShowRightPanelGitHub` |
|
||
| Documents | `ToggleDocumentFill` · `DocumentWidthThird` · `DocumentWidthHalf` · `DocumentWidthTwoThirds` · `ToggleDocumentPreview` · `ToggleDocumentWrap` |
|
||
| SSH | `ToggleSftp` · `ShowSshForwards` · `OpenSshProfiles` |
|
||
| Application | `CloseWindow` (Windows / Linux) · `About` · `CheckForUpdates` · `OpenDocumentation` · `OpenDiscord` · `ReportIssue` · `ShowAll` · `ZoomWindow` |
|
||
|
||
## Rebinding syntax
|
||
|
||
```json
|
||
{
|
||
"keybindings": {
|
||
"ResizePaneLeft": "ctrl-alt-left",
|
||
"ToggleSftp": "secondary-shift-y",
|
||
"ScmSync": "ctrl-b s"
|
||
}
|
||
}
|
||
```
|
||
|
||
`secondary` means <kbd>⌘</kbd> on macOS and <kbd>Ctrl</kbd> elsewhere. A space
|
||
separates the steps of a chord.
|
||
[More →](/customization/keybindings)
|