/nova-tabs-sidebar

Tabs sidebar Nova extension

Primary LanguageTypeScriptMIT LicenseMIT

Tabs Sidebar

Tabs Sidebar provides a sidebar to list and manage your currently open document tabs.

It was inspired by the Tab List Nova extension, but is a complete rewrite with numerous improvements and new features.

List of open tabs

List of open tabs grouped by kind

Context menu items

Sorting menu

Preferences panel

Features

  • Sort by tab bar order, file kind, or alphabetically
  • Sort by custom order using up/down buttons and context menu
  • Custom sort order is saved in project config
  • Group by type, based on syntax
  • Group by folder hierarchy
  • Indicators for unsaved tab, remote tab, and in trash
  • Shows Git status as icon and/or text
  • Right-click context menu with options to "Close Tab", "Show in Finder", "Copy Path", etc.
  • Option to open tab on single click or double click
  • Option to show or hide parent folder names
  • Option to show file count when grouping by kind
  • Localized in French, German, Chinese, and Japanese

Requirements

Git >= 2.15 is required to show Git status

In order to use the Git status feature, Git must be installed and available on the command line, and your Nova project folder must be a Git repo.

Accessibility Permissions

Tabs Sidebar uses AppleScript to read and activate certain menubar items such as "Close Tab", "Show in Files Sidebar", and "Clean Up By Tab Bar Order". Accessibility permissions must be granted to Nova to perform these actions.

To give Nova accessibility permissions:

  • Open System Preferences → Security & Privacy → Privacy, and click the lock to make changes.
  • Scroll down to Accessibility and check on Nova in the list.
  • Scroll down to Automation and check on System Events under Nova.

Usage

To use Tabs Sidebar:

  • From the "All Sidebars" panel, click and drag the "Tabs" item up into the toolbar or out into a new split
  • All open document tabs will be listed in the sidebar. Click or double-click an item to open its tab
  • Click the up/down buttons when a tab or group is selected to rearrange the list
  • Right-click in the sidebar or click the (…) button for sorting options
  • When "Sort Alphabetically" is enabled, custom sorting is not available. When disabled, custom order is restored.
  • When "Group by Kind" is enabled, only custom sorting of group folders is available.

Configuration

To configure global preferences, open Extensions → Extension Library... then select Tabs Sidebar's Preferences tab.

Known limitations

  • Tabs Sidebar cannot rearrange Nova's tab bar because there is currently no API, menu item, or keyboard shortcut for managing tabs order
  • Cannot differentiate between a local file and remote file with the same name, leading to inconsistent opening and sorting. This is due to the Window menu not indicating which files are remote.
  • Does not update list when document file path changes