Skip to content

Main Window

The main window is where you manage all your tunnels.

Window Layout

Area Purpose
Sidebar (left) List of all your tunnels
Detail View (right) Information about selected tunnel
Toolbar (top) Quick actions and settings

The sidebar shows all tunnels with their current status.

Status Indicators

Color Meaning
Green Connected
Gray Disconnected
Yellow Connecting
Red Error

Quick Actions

  • Click a tunnel to see its details
  • Double-click to connect or disconnect
  • Right-click for more options (edit, duplicate, delete)

Search and Filtering

Search filters tunnels in real time across these fields:

Field Example
Tunnel Name "dev-postgres"
Remote Host Server hostname or AWS remote host
SSH User "ec2-user"
Instance ID AWS Instance ID
Local Port "5432"
Remote Port "5432"

To search:

  1. Click the search field at the top of the sidebar (or press Cmd+F)
  2. Type your query -- results update instantly
  3. Press Esc or clear the text to show all tunnels

Search is case-insensitive, matches partial strings, and searches all fields at once.

Detail View

When you select a tunnel, the detail view shows:

  • Status -- connected/disconnected and duration
  • Connection info -- host, ports, SSH user
  • SSH Command -- the underlying command (useful for debugging)
  • Actions -- edit, connect, delete buttons

Dashboard

When no tunnel is selected, the dashboard shows tunnel counts, active connections, and recent activity.

Toolbar

Button Action Shortcut
+ Create new tunnel Cmd+N
Settings Open preferences Cmd+,

Duplicate Tunnel

Create a copy of an existing tunnel:

  • Keyboard: Cmd+D
  • Right-click: Select "Duplicate" from the context menu
  • Menu: Edit > Duplicate

The copy gets "(Copy)" appended to its name. Passwords are not copied -- you must re-enter them.

File Menu

Item Action Shortcut
New Tunnel Create tunnel Cmd+N
Import Import from file Cmd+I
Export Export to file Cmd+E

Edit Menu

Item Action Shortcut
Copy Copy SSH command Cmd+C
Duplicate Copy tunnel Cmd+D
Delete Remove tunnel Cmd+Del

View Menu

Item Action Shortcut
Toggle Sidebar Show/hide sidebar Cmd+\
Connection History Open history Cmd+H

See Keyboard Shortcuts for the complete list.

Tips

Resize the Sidebar

Drag the divider between the sidebar and detail view to adjust widths.

Use the Menu Bar

Enable Show in Menu Bar in Settings > General for quick access without opening the main window.

Copy SSH Commands

Select a tunnel and press Cmd+C to copy the SSH command. Useful for debugging, sharing setup with colleagues, or running manually in Terminal.

Right-Click for Options

Right-click any tunnel for quick access to edit, duplicate, connect/disconnect, copy command, and delete.