# Ntilde user guide

Ntilde is a cross-platform terminal emulator built for correctness, performance and predictability,
with persistent sessions, a built-in SSH client and opt-in access for AI agents.

Shortcuts in this guide are the Windows and Linux defaults. On macOS most use `Cmd` in place of
`Ctrl`; [Keyboard shortcuts](shortcuts.md#macos) lists the exceptions.

## Start here

- [Installing and updating](install.md): Windows, macOS and Linux packages, first run, updates,
  uninstalling, and moving from NovaTerminal.
- [Keyboard shortcuts, the command palette and the mouse](shortcuts.md): every default shortcut,
  how to rebind them, and every palette command.

## Using Ntilde

- [Tabs, panes and workspaces](tabs-and-panes.md): tabs, the vertical sidebar, splits, workspaces,
  templates and bundles.
- [The terminal](terminal.md): cursor, bell and scrolling, notifications, inline images, snapshots,
  recording and replay, and the optional `xterm-ntilde` terminfo entry.
- [Persistent sessions and the multiplexer](persistent-sessions.md): shells that keep running when
  the window closes, SSH tabs that survive a disconnect, and `ntilde mux`.
- [SSH and file transfer](ssh.md): the Connection Manager, profiles, backends, signing in, host
  keys, port forwards and SFTP.
- [Command Assist](command-assist.md): suggestions, history search, fixes and snippets.
- [Shell integration](shell-integration.md): what it gives you, and installing it on remote hosts.
- [Agents](agents.md): the Agent Output panel, and letting AI agents read or drive your sessions
  over MCP.

## Making it yours

- [Settings reference](settings.md): every setting on every page, its default, and the
  `settings.json` file.
- [Themes and fonts](themes-and-fonts.md): built-in themes, importing and writing your own, fonts.
- [Backup and restore](backup.md): moving your configuration between computers, and snapshots.

## Reference

- [Command line](cli.md): `ntilde mux`, `ntilde backup`, `--replay`, `--vt-report` and environment
  variables.
- [Troubleshooting](troubleshooting.md): file locations, logs, common problems and how to report a
  bug.
- [Changelog](../../CHANGELOG.md)