diff --git a/docs/terminal/index.md b/docs/terminal/index.md
index 022630a82..104b73009 100644
--- a/docs/terminal/index.md
+++ b/docs/terminal/index.md
@@ -95,11 +95,37 @@ The terminal inherits your application's theme and font settings. Customize them
 
 When the terminal is focused, application shortcuts are disabled to prevent conflicts with terminal commands. For example, `CTRL + C` sends SIGINT instead of copying.
 
+### Sessions
+
+Keep long-running shells alive and switch between them as needed.
+
+What sessions enable:
+
+* Up to three concurrent terminals: Create and jump between sessions without losing shell state (maximum of three active sessions at a time).
+* Background execution: Commands keep running even if you close the tab or move to a different view.
+* Crash-safe: If the frontend exits unexpectedly, you can reattach later and keep working.
+
+Getting started:
+
+1. Create a session: Opening the terminal automatically starts a session; use the session menu to spin up more.
+2. Switch sessions: Select any existing session to attach instantly—scrollback and history stay intact per session.
+3. Close a session: Exit the shell or use the session menu to terminate it when you're done.
+
+Session behavior and limits:
+
+* Up to three sessions can run at the same time; close an existing session to start a new one if you hit the limit.
+* Sessions do not auto-reconnect after a page reload—you'll need to open the terminal again to start a new session.
+* Session history is preserved only while the session remains active.
+* Each session is tied to its current environment or VPS target.
+* Idle sessions may be reclaimed automatically, depending on server policy.
+
 ## What's Coming Next
 
 * Command sanitization and System protection against harmful commands
 * Privacy safeguards and following best practices
 * Prompt customization
+* Auto-reconnect to the last active session after page reloads or short disconnects
+* Session renaming and enhanced session management controls
 * Multi-editor support
 * Command auto-completion
 * AI-powered command suggestions