# Nexus Terminal Quick Start

Nexus Terminal is a desktop client for SSH, Telnet, RAW TCP, and GitHub sessions. This page is a shareable quick start for everyday use.

## Get connected in minutes

1. Open Nexus Terminal.
2. Click **New** in the sidebar.
3. Choose a protocol and enter the connection details.
4. Click **Connect** to open the session in a new tab.

One-off session? Use **Cmd+Shift+Q** / **Ctrl+Shift+Q** for quick connect.

## Daily workflow

- **Tabs and splits**: Drag tabs to reorder, and split the workspace to view multiple sessions at once.
- **Broadcast input**: Toggle with **Cmd+Shift+B** (macOS) or **Ctrl+Shift+B** (Windows/Linux) to send the same command to all connected sessions.
- **Snippets**: Save common commands and run them with one click.
- **Search**: Press **Cmd+F** (macOS) or **Ctrl+F** (Windows/Linux) to search within the active terminal.
- **Reconnect quickly**: If a session drops, click **Reconnect** on the disconnected overlay.

## File transfers on SSH

Click the **folder** icon on an SSH tab to open the SFTP browser. You can browse, upload, download, rename, and delete files.

### Drag and drop files

Drop file(s) into the terminal and choose to:

- **Upload** to a selected remote folder, or
- **Paste contents** into the terminal as if typed.

The upload picker lists folders only and marks permissions:

- **READ ONLY**: you can read but cannot write
- **NO READ**: you cannot access the folder

## Security basics

- Credentials are stored in the OS keychain where available.
- An encrypted vault is used as a fallback.
- SSH host key checks can be set per profile (Strict, Ask, Accept new, Insecure).

## Common shortcuts

| macOS Shortcut  | Windows/Linux Shortcut | Action                   |
| --------------- | ---------------------- | ------------------------ |
| Cmd + K         | Ctrl + K               | Command palette          |
| Cmd + N         | Ctrl + N               | New connection           |
| Cmd + W         | Ctrl + W               | Close tab                |
| Cmd + F         | Ctrl + F               | Find in terminal         |
| Cmd + Shift + S | Ctrl + Shift + S       | Snippet library          |
| Cmd + Shift + B | Ctrl + Shift + B       | Broadcast input          |
| Cmd + Shift + Q | Ctrl + Shift + Q       | Quick connect            |
| Cmd + Shift + R | Ctrl + Shift + R       | Toggle session recording |
| Cmd + Shift + D | Ctrl + Shift + D       | Split pane vertically    |
| Cmd + Shift + E | Ctrl + Shift + E       | Split pane horizontally  |

## Need more detail?

- Product overview: [docs/overview.md](overview.md)
- User manual: [docs/user-manual.md](user-manual.md)