Tab Management

Tablen uses a tab-based interface for organizing multiple workspaces. Each tab operates independently with its own query, result set, and connection context.

Tab Types

Tab Type	Description	Icon
Query	SQL query editor with result table	Code editor icon
Table Browse	Browse table data directly	Table icon
Structure	View and edit table structure	Structure icon
ER Diagram	Entity-Relationship diagram	Diagram icon
Schema Diff	Compare schemas between connections	Diff icon
Shared Queries	Browse team's shared queries	Share icon
Data Compare	Compare data between tables	Compare icon
Process List	View active database processes	Process icon
Dashboard	Connection-specific dashboard	Dashboard icon
Query Performance	Performance monitoring view	Gauge icon
User Management	Database user administration	Person icon

Creating Tabs

New Query Tab

Shortcut: Cmd+T
Command Palette: Search for "New Tab"
Creates a new empty query tab

Special Tabs

Special tabs (Table Browse, Structure, ER Diagram, etc.) are created through context menus and sidebar actions:

Table Browse: Double-click a table name in the sidebar
Structure: Right-click a table and select "View Structure"
ER Diagram: Right-click a connection and select "ER Diagram"
Schema Diff: Available from the Tools menu
Dashboard: Right-click a connection and select "Dashboard"
Process List: Right-click a connection and select "Process List"
Query Performance: Available from the Tools menu or Command Palette

Switching Tabs

Click: Click on a tab in the tab bar
Keyboard: Cmd+1 through Cmd+9 to switch to tabs 1-9
Tab bar shows tab type indicators and connection context

Closing Tabs

Shortcut: Cmd+W closes the active tab
Close Button: Click the X button on the tab
Close Other Tabs: Right-click a tab and select "Close Other Tabs"
Close Tabs to Right: Right-click a tab and select "Close Tabs to Right"

Tab Operations

Pin Tab

Pin important tabs to prevent accidental closure:

Right-click a tab and select "Pin Tab"
Pinned tabs move to the left side of the tab bar
Pinned tabs cannot be closed with Cmd+W (you must unpin first)

Duplicate Tab

Create a copy of an existing tab:

Right-click a tab and select "Duplicate Tab"
The duplicated tab inherits the query, connection, and settings

Move Tab

Reorder tabs in the tab bar:

Right-click a tab and select "Move Left" or "Move Right"
Drag and drop tabs to reorder

Tab Persistence

Tabs are saved and restored between app sessions:

All open tabs are preserved when you quit Tablen
Tab state includes: query text, scroll position, result data, and connection context
Stored in ~/Library/Application Support/DBClient/tabs.json

Tab State

Each tab maintains its own independent state:

Query text: The SQL in the editor
Result set: The query results displayed in the result table
Connection context: Which database connection the tab is associated with
Editor visibility: Whether the SQL editor pane is shown or hidden
Pending changes: Uncommitted inline edits in the result table
Execution state: Whether a query is currently running