Saved sessions

Sessions are the entries in the left-hand sidebar: saved connections you can reconnect with one click. Sessions live next to your documents — passwords and passphrases stay in the macOS Keychain, everything else on your machine.

The session sidebar

• Double-click a session to connect.
• Rename inline, nest groups (folders can have a parent, and you drag them into order), and filter by a set of tags with the filter bar — the bar can be switched off.
• Search the session tree with the filter field.
• A compact mode (a setting) changes row density only.
• “Move to…” moves a session or a folder without dragging.

Groups

• New group… in the context menu of the sidebar’s empty area creates a group at the top level.
• New group… in a folder’s context menu creates a group inside that folder. The prompt reads New group in ”…”, and after Create the folder opens so you see the new group.
• Wherever you choose a group — the session editor’s Group picker, the Move to menu, the Cyberduck import — each group is shown with its full path, for example Work / Prod, so two groups with the same name are told apart.
• The session editor has a New group… button beside the Group picker. It creates a group inside the group the picker shows, or at the top level when the picker shows No group, and selects it. The group stays even if you then cancel the editor.
• If the folder you are creating a group in was deleted in the meantime, nothing is created and the sidebar says “the selected folder no longer exists”.

The session overview

A single click on a session shows its details before you connect:

• Connection facts — protocol, host, and the like, derived from what is stored. The Group fact shows the group’s full path.
• Recent connections — the session’s own connection history.
• Snippets — the session’s snippets with a one-click Run; running one connects, opens the terminal, and sends the command.
• Three actions for the session, including export.

The overview never covers something that needs your answer: a pending host-key question, or a failure you have not dismissed yet, stays on the connection form until you deal with it.

Editing a session

The session editor holds the connection details, the login and the group. It also has:

• a Resolve… button beside the host field, for SSH sessions — see First connection,
• a Terminal type choice for SSH sessions — see Terminal type.

Duplicate and organize

• Duplicating a session carries references, not secrets — the duplicate points at the same keychain entry rather than copying a password around.
• A name that would replace another session warns you first. Saving then replaces exactly the session the warning named, even when the name you typed has extra spaces around it.
• Sessions export and import with their nesting carried along. Importing over an existing session keeps its terminal type unless the file sets one.

Import from Cyberduck

macSCP can bring in your existing Cyberduck bookmarks — see Import from Cyberduck.

Where your data lives

Per-session audit logs are stored in ~/Library/Application Support/macSCP/audit/, one file per saved connection. Deleting a saved connection deletes its log. Settings → Manage Data shows the folders the app uses.