# Termy

- [Termy documentation](/docs): Install Termy, learn the daily workflows, and shape it around how you work.

- **Install & setup**
- Getting started
  - [Getting started](/docs/getting-started): Go from download to a comfortable Termy setup in a few minutes.
  - [Install](/docs/getting-started/installation): Download Termy for macOS, Linux, or Windows.
  - [Config file](/docs/getting-started/config-file): Where settings live and how to edit them.
  - [Troubleshooting](/docs/getting-started/troubleshooting): Common install and launch issues.

- **Daily workflows**
- Using Termy
  - [Using Termy](/docs/using-termy): Everyday terminal workflows, from one shell to persistent workspaces.
  - [Tabs](/docs/using-termy/tabs): Open, switch, rename, and organize tabs.
  - [Splits and panes](/docs/using-termy/splits-panes): Split, focus, resize, and zoom panes.
  - [Search](/docs/using-termy/search): Find text in scrollback.
  - [Command palette](/docs/using-termy/command-palette): Search actions, themes, settings, and tasks.
  - Plugins
    - [Plugins](/docs/using-termy/plugins): Add commands, automations, and safe native tools to Termy.
    - [Getting started](/docs/using-termy/plugins/getting-started): Create, install, and develop a Termy plugin.
    - [Commands and context](/docs/using-termy/plugins/commands-context): Define palette commands, inputs, settings, actions, and keybindings.
    - [Native UI](/docs/using-termy/plugins/native-ui): Build safe JSX tools that Termy validates and renders with GPUI.
    - [Lifecycle and storage](/docs/using-termy/plugins/lifecycle-storage): React to terminal activity and persist plugin-specific data.
    - [Security and limits](/docs/using-termy/plugins/security-limits): Understand plugin trust, import rules, isolation, reloads, and boundaries.
  - [SSH hosts](/docs/using-termy/ssh-hosts): Save remote hosts and open them in native Termy tabs.
  - [Tmux sessions](/docs/using-termy/tmux-sessions): Optional tmux-backed tabs and panes.
  - [Tasks and layouts](/docs/using-termy/tasks-layouts): Named commands launched from the palette.

- **Settings & themes**
- Customize
  - [Customize Termy](/docs/customize): Change how Termy looks, responds, and fits into your workflow.
  - [Appearance](/docs/customize/appearance): Theme, font, window, and padding.
  - [Terminal Behavior](/docs/customize/terminal-behavior): Shell, cursor, scrolling, clipboard, and terminal UI behavior.
  - [Tabs and Titlebar](/docs/customize/tabs-titlebar): Tab titles, tab strip behavior, and title bar.
  - [Colors](/docs/customize/colors): Override theme colors with hex values.
  - [Themes](/docs/customize/themes): Built-in and custom JSON themes.
  - [Keybindings](/docs/customize/keybindings): Override shortcuts in config.txt.
  - [Advanced](/docs/customize/advanced): Updates, startup, debug, and safety.

- **Exact reference**
- Reference
  - [Reference](/docs/reference): Exact configuration keys, default shortcuts, and action names.
  - [Configuration Reference](/docs/reference/configuration-reference): Canonical list of Termy configuration keys and defaults.
  - [Defaults](/docs/reference/keybinding-defaults): Default keybindings on each supported platform.
  - [Actions](/docs/reference/actions): Every action you can bind to a trigger.

- **AI agent tools**
- Agent skills
  - [Agent skills](/docs/skills): Install Termy's skills for coding agents.
  - [Migrate from Ghostty with an agent](/docs/skills/ghostty-to-termy): Convert a Ghostty config to Termy.
  - [Build plugins with an agent](/docs/skills/build-termy-plugins): Build Termy plugins with a coding agent.

- **Develop & embed**
- Developer
  - [Develop and embed](/docs/developer): Understand Termy's boundaries, measure rendering, or build with libtermy.
  - [Command Boundary](/docs/developer/command-boundary): Ownership boundaries between the command engine and adapters.
  - [Render Metrics](/docs/developer/render-metrics): Debug terminal rendering performance.
  - [libtermy](/docs/developer/libtermy): Embed Termy's beta terminal engine in Rust, C, Swift, and other native hosts.