Please enable JavaScript to view this site.

Navigation: Take Command

Semantic Scrollback

Scroll Prev Top Next More

The semantic scrollback overview is a compact navigation strip immediately to the left of a terminal tab's vertical scrollbar. It summarizes important locations in retained terminal history, making long-running sessions easier to navigate without rendering a second copy of the terminal.

 

It is enabled by default for new terminal tabs.

 

Using the overview

 

•Click a position in the strip to center the corresponding scrollback location when possible.

•Drag with the left mouse button to move continuously through scrollback.

•Hover a position to see its one-based scrollback row and any marker categories at that row.

•The outlined rectangle shows the part of scrollback currently visible in the terminal.

 

The normal scrollbar remains unchanged. Its arrows, thumb, mouse wheel behavior, keyboard navigation, and existing prompt/result ticks continue to work as before.

 

The overview is navigation-only: it does not modify terminal text, command results, folding, recordings, or a live connection.

 

Markers

 

The strip can show the following markers when the corresponding retained terminal data is available:

 

Marker

Meaning

Command boundary

Beginning of a recognized command block.

Command result

A command result or prompt marker. Successful, failed, and pending/unknown results use the same result colors as the scrollbar ticks.

Search match

A scrollback or command-search match. The active match is outlined for emphasis.

Annotation

A row with a terminal annotation.

Trigger hit

A retained terminal regex-trigger match.

Inline image

The anchor row of a retained SIXEL, iTerm, or other supported inline image. The overview does not display image thumbnails.

 

When several categories occur at the same row, the most important visible marker is drawn while the hover text lists every category. Active search and failed command results take priority so they remain easy to find.

 

Markers for rows hidden by a folded command block are not shown until that block is expanded. Markers naturally disappear when their terminal rows leave the retained scrollback buffer.

 

Supported tabs

 

The overview is available for local ConPTY, SSH, serial, replay, and read-only tabs when their retained history contains applicable information. A category is simply absent when a session type does not supply it.

 

Alternate-screen applications do not show a meaningful overview while they have no retained scrollback history.

 

Privacy

 

The overview stores no transcript or second terminal rendering. It uses a small, read-only snapshot of retained row positions and marker categories.

 

Hover text shows only the scrollback row number and category names. It never shows command text, trigger parameters, credentials, passwords, remote-host details, or inline-image contents.

 

Configuration

 

The setting is in the Settings /Tabs configuration page.

 

Restart Take Command after changing this setting. The setting is global and affects terminal tabs created after Take Command starts; it does not alter scrollback content or remove existing markers.

 

Troubleshooting

 

Issue

Resolution

The overview is not visible

Confirm TabPtySemanticOverview=Yes in the active TCMD.INI, restart Take Command, and open a new terminal tab.

The strip has no markers

Generate retained terminal history, run a searchable command, add an annotation, or wait for another supported event. Not every session type supplies every marker category.

A marker appears to be missing

Expand folded command blocks and verify that the row has not already scrolled out of the retained buffer.

A click does not land on an exact output line

The overview maps a narrow pixel strip over the full retained history. Click again or use the normal scrollbar for fine-grained positioning.