History

The History tool displays the jobs reported by shell integration that have been run in each terminal. The most recent jobs are displayed at the bottom of the list, which can be set to autoscroll as new jobs are appended (The tool's search bar contains the autoscroll option). The History tool provides access to convenient job-related actions, including:

• Scrolling to the start or end of a job within the terminal scrollback.
• Copying or selecting the entire text of the job or just the command or output portions.
• Writing a command to the active terminal, either with or without a trailing newline.
• Annotating a job.

Jobs are displayed in the History tool using the same colors as their parent terminal. The icon displayed with each job is derived by matching its command against the icon autoswitch rules that reference the proc.comm attribute. The exit status column uses the same display format as the Marks tool. The tool's font and capacity are configurable under the History and Notes Tools category in the Global settings. Via global settings, certain actions can be configured to run on a double-click, Control-click, Shift-click, or middle-click of a job.

The History tool is both navigable and searchable, having a current selection that can be moved and acted upon using generic or tool-specific actions. Searches entered into the tool search bar will filter the list of jobs, showing only those jobs whose commands match the search string. Several table columns besides the command text and exit status are available, including the line number, username, hostname, directory, start time, and duration. Drag table column headers to reorder them and use the header's context menu to show and hide individual columns. If the table header is not visible, show it using Tools→Display or ToggleToolTableHeader. Sorting is not supported; jobs are always displayed in chronological order by their start time.

Each job will be added to the History tool as soon as it is reported by shell integration. When the exit status of the job is reported, the job will be updated and a brief animation will be shown. When a job's terminal has been closed or the job has scrolled off the top of its terminal's scrollback buffer, the contents of the job region will be lost and some tool functions such as copy and select will not be available.

The History tool can be filtered by terminal and server using Tools→Filter, the context menu, or by calling the various ToolFilter actions directly. Individual terminals or all terminals belonging to a given server can be whitelisted or blacklisted using filter actions. Jobs belonging to closed terminals can also be removed from the list using the filter menu or ToolFilterRemoveClosed. Note that the tool filter is shared between the History, Annotations, and Tasks tools.

The nearby figure shows the History tool in a typical situation. Jobs from two terminals are visible: one using a light-background theme and one using a dark-background theme. The job with the command string git status is selected.

Example of a typical History tool with a selected job.