Please enable JavaScript to view this site.



Bookmarks mark important retained rows in a Take Command tab window. They are useful for returning to an error, a deployment step, a device message, or any other line in long-running output.

 

Bookmarks are available in Local ConPTY, SSH, Serial, and read-only replay tabs. They are local Take Command metadata: creating or editing one never sends text or control sequences to the terminal, remote host, or serial device.

 

Create and navigate bookmarks

 

Place the terminal cursor on the row you want to mark, then use one of these commands:

 

Command

Shortcut

Result

Toggle Terminal Bookmark

Ctrl+F2

Adds a bookmark to the current row, or removes its existing bookmark.

Next Terminal Bookmark

F2

Moves to the next bookmark, wrapping to the first bookmark.

Previous Terminal Bookmark

Shift+F2

Moves to the previous bookmark, wrapping to the last bookmark.

Edit Terminal Bookmark

None

Adds or changes the optional label on the current bookmarked row.

Clear Terminal Bookmarks

Ctrl+Shift+F2

Confirms and removes every bookmark in the active tab.

 

The terminal gutter shows a bookmark glyph beside marked rows. Matching markers in the scrollbar provide a quick visual overview of bookmarks throughout retained scrollback.

 

When a bookmark is inside a collapsed command block, navigating to it expands that block so the bookmarked row is visible.

 

Labels

 

Use Edit Terminal Bookmark to give a bookmark a short descriptive label, such as before deployment or timeout response.

 

•Labels are optional.

•An empty label clears the label but keeps the bookmark.

•Labels can contain up to 256 UTF-16 characters.

•Control characters are not accepted.

 

Labels are exposed to accessibility tools and can be included with exported bookmarked lines. They are not displayed as terminal output and are never sent to the terminal session.

 

Copying and saving marked output

 

Use Copy Bookmarked Terminal Lines to copy marked rows to the clipboard, or Save Bookmarked Terminal Lines to choose a file with Save As.

Take Command processes bookmarked rows in terminal-row order, not the order in which you created them. If a bookmark has a label, the export includes a localized label header before that row. Terminal escape sequences and hidden wide-character trail cells are not included.

 

Output can continue arriving while you export. Rows that have left retained scrollback before extraction are skipped and Take Command reports that condition.

 

Where to find the commands

 

The terminal bookmark commands are available when a terminal or replay tab is active:

 

•Edit menu;

•the terminal caption-bar menu;

•the terminal right-click menu;

•the Command Palette; and

•the shortcuts listed above.

 

The right-click menu uses the row under the pointer, so it is convenient for adding a marker to an earlier scrollback row without moving the terminal cursor.

 

Settings

 

The global Tabs settings control bookmark presentation:

 

Setting

Default

Effect

TabPtyBookmarks

Yes

Enables bookmark commands and overlays for terminal views.

TabPtyBookmarkGutter

Yes

Shows or hides gutter glyphs. Scrollbar markers remain available.

TabPtyBookmarkColor

Theme accent

Sets the bookmark marker color.

 

Changing these settings updates existing terminal tabs immediately. Disabling bookmarks hides controls and overlays but retains the current tab's in-memory bookmarks until you re-enable the setting or the terminal buffer is reset.

 

Retention and replay

 

Bookmarks track logical retained scrollback rows. If normal output evicts a row from the terminal’s scrollback buffer, its bookmark is removed before that storage is reused; it never attaches to unrelated later output.

 

Bookmarks are intentionally not saved as rows in TCMD.INI. Scrollback belongs to one live process, host, serial device, or recording and cannot safely be restored for a different session.

 

When recording is enabled, bookmark additions, edits, removals, and clears are recorded as private metadata. During replay and seeking, Take Command rebuilds the bookmark set that applied at the selected recording time. Older recordings without bookmark metadata continue to work normally.

 

Limits and troubleshooting

 

Each terminal tab can hold up to 1,024 bookmarks. If you reach that limit, remove unneeded bookmarks before adding another.

 

Symptom

What to check

F2 does nothing

The active tab has no retained bookmarks, or bookmark commands are disabled in Tabs settings.

A bookmark disappeared

The corresponding row was evicted by new output, or the terminal buffer was reset.

No gutter marker is visible

Enable TabPtyBookmarkGutter; the bookmark may still appear in the scrollbar.

A label is rejected

Remove control characters and shorten the label to 256 characters or fewer.

Export omits a bookmark

Its row was no longer retained when the copy/save operation ran.