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.
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.
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.
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.
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.
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.
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.
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. |