From c3f47df958494743c1b04ac3aa0ed6e07311a1a0 Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Sun, 4 Oct 2026 23:39:44 +0000
Subject: [PATCH] docs: document terminal scrollbar command-history markers

Add a section to the dashboard terminals guide describing the updated
overlay scrollbar's circular command-history markers, marker
displacement around the thumb, and the retained-text-based command
mark lifetime introduced by the Hex1b 0.172.0 upgrade.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 src/frontend/src/content/docs/dashboard/terminals.mdx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/frontend/src/content/docs/dashboard/terminals.mdx b/src/frontend/src/content/docs/dashboard/terminals.mdx
index 830159b2c..0d97b3b01 100644
--- a/src/frontend/src/content/docs/dashboard/terminals.mdx
+++ b/src/frontend/src/content/docs/dashboard/terminals.mdx
@@ -201,6 +201,12 @@ A detached window starts with the originating viewer's selected font size, then
 
 Multiple viewers can share a terminal, but only one is the **primary** viewer that controls the process's grid dimensions. Opening a detached window requests that role. Revealing or returning to an active dock pane also requests sizing control. Explicit sizing actions can request control; ordinary typing and pasting don't. A viewer that loses control doesn't continuously reclaim it from another viewer.
 
+## Browse command history with the scrollbar
+
+The terminal's overlay scrollbar shows circular markers for OSC 133 command checkpoints alongside the scroll thumb, so you can jump to earlier commands without scrolling through their output line by line. When markers would overlap the thumb, the renderer displaces the nearby markers so they stay visible and clickable beside it. The track and thumb colors follow the active terminal palette, and the markers keep their own color so they remain visible against either palette.
+
+Command marks remain available for as long as their backing scrollback text is retained, rather than being evicted after a fixed number of commands. Very old marks can still be dropped once their backing text scrolls out of the retained history.
+
 ## Navigate with the keyboard
 
 Terminal applications handle many keys themselves, including keys normally used to navigate a web page.