# tty7

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

## Docs

- [tty7](https://tty7.io/index.md): A terminal workbench: persistent sessions, remote work, agents.
- [Installation](https://tty7.io/getting-started/installation.md): Native builds for macOS, Windows, and Linux — plus building from source.
- [First launch](https://tty7.io/getting-started/first-launch.md): The handful of settings worth changing before you start working.
- [Core concepts](https://tty7.io/getting-started/concepts.md): Workspaces, tabs, panes — and the background server that owns them all.
- [Tabs and splits](https://tty7.io/window/tabs-and-splits.md): Opening, arranging, and rearranging the panes in a tab.
- [The sidebar](https://tty7.io/window/sidebar.md): Tabs grouped by repository, with branch, diff counts, and agent status on every row.
- [Command palette](https://tty7.io/window/command-palette.md): One key for every action in the app — including the ones with no shortcut.
- [Search](https://tty7.io/window/search.md): Finding text in the scrollback, and everything else the search boxes cover.
- [The side panel](https://tty7.io/window/side-panel.md): Info, Source Control, and Files — plus the built-in editor.
- [The prompt](https://tty7.io/terminal/prompt.md): Ghost suggestions, tab completion that explains itself, syntax highlighting, and real multi-line editing.
- [History](https://tty7.io/terminal/history.md): Fuzzy history search, and whether each pane gets its own.
- [Selection and clipboard](https://tty7.io/terminal/selection-and-clipboard.md): Smart double-click, copy on select, and the settings around them.
- [Links](https://tty7.io/terminal/links.md): Opening URLs, files, and localhost ports straight out of the terminal.
- [Mouse, scrolling, and the bell](https://tty7.io/terminal/mouse-and-scrolling.md): How the pointer, the wheel, and ^G behave — and how to change each.
- [Coding agents](https://tty7.io/agents/overview.md): What tty7 does around Claude Code, Codex, and 17 others — without ever wrapping them.
- [Status and notifications](https://tty7.io/agents/status.md): Installing the hooks, reading the dots, and being told when an agent needs you.
- [Agent sessions](https://tty7.io/agents/sessions.md): Resuming a conversation after a reboot, forking a live one, and getting at the session id.
- [Orchestrating agents](https://tty7.io/agents/orchestration.md): One agent opening a pane for another, waiting on it, and reading the result.
- [SSH](https://tty7.io/remote/ssh.md): A native Rust SSH stack: quick connects, saved profiles, keychain credentials, jump hosts.
- [SFTP](https://tty7.io/remote/sftp.md): A file browser for the machine on the other end of the connection.
- [Port forwarding](https://tty7.io/remote/port-forwarding.md): Local, remote, and dynamic forwards — preconfigured or added mid-session.
- [Remote workspaces](https://tty7.io/remote/workspaces.md): Whole workspaces hosted on another machine — files, repos, panes, and git all stay over there.
- [Source control](https://tty7.io/git/source-control.md): Stage, commit, branch, and push from the panel beside your terminal.
- [Diffs](https://tty7.io/git/diffs.md): The diff overlay: side-by-side or unified, from the sidebar or the panel.
- [Worktrees](https://tty7.io/git/worktrees.md): An isolated checkout on a fresh branch, in one dialog and one tab.
- [Settings](https://tty7.io/customization/settings.md): What lives in each section, and how the settings file works.
- [Themes](https://tty7.io/customization/themes.md): Thirteen built-ins, your own YAML themes, iTerm2 imports, and a colour editor.
- [Fonts](https://tty7.io/customization/fonts.md): The bundled default, fallback chains, ligatures, and why CJK needs a word.
- [Keybindings](https://tty7.io/customization/keybindings.md): Rebinding anything, chord sequences, and the tmux preset.
- [The tty7 command](https://tty7.io/cli/overview.md): Driving the workbench from a script, a Makefile, or another agent.
- [Command reference](https://tty7.io/cli/reference.md): Every verb, its flags, and the JSON it emits under --json.
- [The agent skill](https://tty7.io/cli/agent-skill.md): Teaching a coding agent to use tty7 properly — including when not to.
- [config.json](https://tty7.io/reference/configuration.md): Every key tty7 reads, its type, and its default.
- [Keyboard shortcuts](https://tty7.io/reference/keyboard-shortcuts.md): Every default binding, plus the action names for rebinding.
- [Shell integration](https://tty7.io/reference/shell-integration.md): What tty7 injects into your shell, and what it buys you.
- [Updates](https://tty7.io/reference/updates.md): How tty7 updates itself, and what the two channels mean.
- [Privacy and permissions](https://tty7.io/reference/privacy.md): What macOS asks you, why, and what tty7 itself holds.
- [Troubleshooting](https://tty7.io/reference/troubleshooting.md): The things that go wrong, and what they actually mean.