Skip to content
Reference > Settings & account

Sessions

Session-level behavior and shell integration options.


The Sessions page currently holds one setting, covering how Mel treats interactive SSH sessions. It's deliberately small: Mel only surfaces toggles whose behavior is actually wired, and session behavior beyond SSH hasn't needed a switch yet.

SSH

Melt SSH sessions into a remote agent

On by default. When you're inside an interactive ssh session, pressing ctrl+enter starts an agent conversation whose tools run on the remote host — reading files, listing directories, searching, and running commands all execute over your existing ssh connection, with nothing installed on the remote machine.

With this toggle on:

  • Run ssh user@host as usual — the session renders as a full interactive terminal.
  • Press ctrl+enter at any point to melt it. The conversation landing shows the remote target (for example user@host:~), and every agent tool call from then on is routed through ssh to that host.
  • Model calls still go through the Mel relay as normal; only the *tools* move to the remote side. See Privacy for exactly what leaves your machine.

Turn the toggle off if you never want ctrl+enter inside an SSH session to start a remote agent — for example, if the remote application you're using binds that key itself.

Where it persists

Like everything in Settings, the change applies immediately and is saved to ~/.mel/settings.json (field: ssh_melt). See the Settings overview for the full persistence picture.

A few session-shaped settings live on other pages by topic:

  • Maximum blocks per session and the new-session help block are on Features.
  • Agent input behavior inside conversations (shell autodetect, hints) is on AI.
  • Block rendering (dividers, compact headers, pane dimming) is on Appearance.