From b76242f547a6eb9f0293fc5b49ef9e3da8a5f045 Mon Sep 17 00:00:00 2001
From: tnspacetime <187045796+tnspacetime@users.noreply.github.com>
Date: Thu, 6 Aug 2026 18:33:38 -0400
Subject: [PATCH] docs: explain projects and sessions

---
 packages/web/src/content/docs/index.mdx | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/web/src/content/docs/index.mdx b/packages/web/src/content/docs/index.mdx
index 90e7eafb2f31..b9bc53d6f1cf 100644
--- a/packages/web/src/content/docs/index.mdx
+++ b/packages/web/src/content/docs/index.mdx
@@ -192,6 +192,28 @@ used.
 
 ---
 
+## Projects and sessions
+
+OpenCode works on the **project** you opened during initialization.
+
+A **session** is one conversation or task within that project. You can have multiple sessions for the same project, each with its own context and history.
+
+Start a new session with:
+
+```text
+/new
+```
+
+Return to an existing session with:
+
+```text
+/sessions
+```
+
+Starting a new session lets you begin a different task without losing the work or conversation from your other sessions. When you quit OpenCode, the session ID is displayed.
+
+---
+
 ## Usage
 
 You are now ready to use OpenCode to work on your project. Feel free to ask it