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@hostas usual — the session renders as a full interactive terminal. - Press
ctrl+enterat any point to melt it. The conversation landing shows the remote target (for exampleuser@host:~), and every agent tool call from then on is routed throughsshto 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.
Related session controls elsewhere
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.