Skip to content
Reference > Settings & account

Features

Feature toggles for the terminal and agent experience.


The Features page holds session and notification behavior — the small set of knobs that shape how a terminal session grows and how Mel gets your attention. Everything applies immediately and persists to ~/.mel/settings.json.

Session

Maximum blocks per session

A numeric field controlling how many command blocks a session keeps before the oldest ones are pruned. You can set any value from 100 to 5000; values outside that range are clamped. The default is 5000, which is also a hard ceiling — it exists so a very long-lived session can't grow without bound and slow the app down. If you routinely run high-output sessions and care about memory, lower this.

Show help block in new sessions

On by default. Controls the keyboard-hints card shown on an empty terminal session (the "New terminal session" landing content). Turn it off once you know the shortcuts and want new sessions to start completely clean.

Notifications

Toast notifications stay visible for

A numeric field, in seconds, controlling how long a notification flash card stays on screen. Accepts 2 to 30 seconds; the default is 6.

For context: Mel raises a notification when an agent in a *background* tab becomes blocked (waiting on your approval) or finishes its task. The flash card appears top-right for this many seconds; the notification also lands in the inbox behind the titlebar bell either way, so nothing is lost if you miss the toast.

What's intentionally not here

Mel's settings surface only shows controls whose behavior is actually wired — if you're looking for a toggle that doesn't exist yet, it's because the feature behind it doesn't either. Appearance-related options (dividers, headers, dimming) live on the Appearance page, agent behavior on the AI page, and SSH behavior on the Sessions page.