Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion connections/ssh-profiles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ One bastion, many connections. A profile holds the server (host, port, username)

## Edit and delete

**Edit Profile…** opens the selected profile, and **Delete Profile** is at the bottom of that editor. An edit reaches every connection using the profile, on this Mac and on any Mac it syncs to: the server, the authentication method, the jump hosts, the password, the key passphrase and the TOTP secret all come from the profile on the next connect.
**Edit Profile…** opens the selected profile, and **Delete Profile** is at the bottom of that editor. An edit reaches every connection using the profile, on this Mac and on any Mac it syncs to: the server, the authentication method, the jump hosts, the password, the key passphrase and the TOTP secret all come from the profile on the next connect. A connection already open keeps the server and jump hosts it connected through. Once the profile points elsewhere, a reconnect TablePro starts on its own, a database switch that reconnects, and a connect asked for by an MCP client or a link stop with a message; **Reconnect** in the connection's window uses the new server. Approvals to sign in with this Mac's own credentials or environment variables are asked for again after a profile moves to another server.

Deleting a profile hands its configuration and its secrets to each connection that used it, as that connection's own inline tunnel. Nothing stops connecting, and the tunnel is now editable per connection under **SSH Tunnel**.

Expand Down
2 changes: 1 addition & 1 deletion connections/urls.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -281,7 +281,7 @@ When another client also handles the scheme, `open -b com.TablePro "mysql://…"

Every URL opened from outside the app raises an **Open External Database Connection?** alert naming the database type, host and port or socket, user, and database. **Connect** does not answer the Return key. Escape is the only keyboard answer, and it cancels.

**Always Allow** appears only for a database on this machine (`localhost`, `127.x.x.x`, `::1`, or a socket). A trusted link is matched on database type, host, socket, database, username, and the URL's `name` parameter, never the port, so the same link on a different port still connects without asking again. Trusting `localhost` does not cover a socket link. Trusting one socket does not cover another, and a PostgreSQL socket on another port is another socket. Remote hosts always prompt, and so does a link through an SSH tunnel, whose database is on the SSH server.
**Always Allow** appears only for a database on this machine (`localhost`, `127.x.x.x`, `::1`, or a socket). A trusted link is matched on database type, host, socket, database, username, and the URL's `name` parameter, never the port, so the same link on a different port still connects without asking again. Trusting `localhost` does not cover a socket link. Trusting one socket does not cover another, and a PostgreSQL socket on another port is another socket. Remote hosts always prompt, and so does a link to a connection reached through an SSH tunnel, an SSH profile, a SOCKS proxy, a tunnel command, Cloudflare or the Cloud SQL Auth Proxy, whose database is on another machine. The alert names each of those it would go through. A link that opens a saved connection is trusted for that saved connection only, so trusting it covers no other saved connection and no link that opens none.

A link with a [filter](#filtering) asks every time and offers no **Always Allow**. Read the filter in the box under the target before choosing **Connect**: it runs on the table as soon as the connection opens.

Expand Down
2 changes: 1 addition & 1 deletion customization/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -111,4 +111,4 @@ Keyboard and License are not in the table. Stock keyboard chords are on [Keyboar

## Where settings live

The file is `~/Library/Preferences/com.TablePro.plist`. **Reset All Settings to Defaults** on the General tab puts every tab back to its stock value after a confirmation, and that includes emptying the AI provider list. Saved connections, query history, and MCP tokens survive it.
The file is `~/Library/Preferences/com.TablePro.plist`. **Reset All Settings to Defaults** on the General tab puts every tab back to its stock value after a confirmation, and turns iCloud sync off, password sync included. Saved connections, AI providers with their API keys and the **Enable AI Features** switch, query history, and MCP tokens survive it.
2 changes: 1 addition & 1 deletion faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Ordinary queries and results go to your database. Mac usage data is on by defaul
</Accordion>

<Accordion title="Is my password safe?">
Passwords go into the macOS Keychain, not the connections file. An ordinary export leaves them out, the Team Library carries the connection definition and query text only, and MCP clients query through your saved connections without seeing one. Two exceptions: **Copy Connection String** puts the password on the clipboard in plain text, and an encrypted export (Pro) carries credentials behind a passphrase. See [Connection Sharing](/features/connection-sharing).
Passwords go into the macOS Keychain, not the connections file. An ordinary export leaves them out, the Team Library carries the connection definition and query text only, and MCP clients query through your saved connections without seeing one. Two exceptions: **Copy Connection String** puts the password on the clipboard in plain text, marked concealed so clipboard history apps that honor the marker skip it, and an encrypted export (Pro) carries credentials behind a passphrase. See [Connection Sharing](/features/connection-sharing).
</Accordion>

<Accordion title="Where does my data live on disk?">
Expand Down
2 changes: 1 addition & 1 deletion features/ai-assistant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,7 @@ Type `@` in the composer to open a picker at the caret: **Schema**, a specific *

### Slash commands

Type `/` for **`/review`**, **`/explain`**, **`/optimize`**, and **`/fix`**, or **`/help`** for the list. The first three act on the text typed after the command, or on the whole query tab when there is none, and attach the same table structure as the menu actions. **`/fix`** sends the tab's last failed statement with its error. Add your own under **Settings > AI > Custom Slash Commands**: a template substitutes `{{query}}`, `{{schema}}`, `{{database}}`, and `{{body}}`, the text typed after the command, at send time. A custom command with a built-in's name runs only from the command menu.
Type `/` for **`/review`**, **`/explain`**, **`/optimize`**, and **`/fix`**, or **`/help`** for the list. The first three act on the text typed after the command, or on the whole query tab when there is none, and attach the same table structure as the menu actions. **`/fix`** sends the tab's last failed statement with its error. Add your own under **Settings > AI > Custom Slash Commands**: a template substitutes `{{query}}`, `{{schema}}`, `{{database}}`, and `{{body}}`, the text typed after the command, at send time. A custom command with a built-in's name runs only from the command menu. Deleting one asks first, since the deletion reaches every Mac that syncs settings.

### Model picker

Expand Down
4 changes: 2 additions & 2 deletions features/er-diagram.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -105,15 +105,15 @@ A table whose primary key is made of two foreign keys, `user_roles` and its like

| Format | File | Contents |
|--------|------|----------|
| PNG | `er-diagram.png` | A bitmap at twice screen resolution, with 40 points of padding |
| PNG | `er-diagram.png` | A bitmap at twice screen resolution, with 40 points of padding. A diagram too large for 16,384 pixels on a side or about 33 million pixels is scaled down to fit |
| SVG | `er-diagram.svg` | Shapes and text as vectors; the key, link and table icons are small embedded bitmaps |
| PDF | `er-diagram.pdf` | One page sized to the diagram, with text that Preview can search and select |
| Mermaid | `er-diagram.mmd` | An `erDiagram` block: each table with its columns, types and `PK` and `FK` markers, and each foreign key with the cardinality the diagram draws |
| Graphviz DOT | `er-diagram.gv` | A table per node, one row per column, and an edge between the two column ports for each foreign key. Render it with `dot -Tsvg er-diagram.gv -o er-diagram.svg` |

PNG, SVG and PDF keep the window's colors and the table positions on screen. Mermaid and DOT list tables by name and columns in table order, so exporting an unchanged schema twice writes the same file and a diff shows only real changes.

**Copy as Mermaid** puts the block on the clipboard inside a `mermaid` code fence, ready to paste into a GitHub comment or any Markdown that renders Mermaid. `Cmd+C` copies the PNG image.
**Copy as Mermaid** puts the block on the clipboard inside a `mermaid` code fence, ready to paste into a GitHub comment or any Markdown that renders Mermaid. `Cmd+C` copies the PNG image, scaled down the same way. For a very large diagram at full size, export SVG or PDF.

Mermaid accepts fewer characters in a type or column name than SQL does. A space, comma or quote becomes an underscore, so `character varying(255)` reads `character_varying(255)`, and a column named `pk`, `fk` or `uk` gets a leading underscore.

Expand Down
2 changes: 1 addition & 1 deletion features/keyboard-shortcuts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -354,7 +354,7 @@ Choose Vim or Emacs under **Settings > Editor > Key bindings**. Either applies o

## Customizing shortcuts

Open **Settings > Keyboard** (`Cmd+,`). Each action has a recorder field: click it and press the new combination, and the menu bar updates immediately. Actions are listed under their own names there: the sidebar toggle is Toggle Table Browser. Filter with the search field, press `Delete` in a recorder field to clear a binding, click the curved-arrow button beside a changed shortcut to restore that one, or **Reset to Defaults** to restore all.
Open **Settings > Keyboard** (`Cmd+,`). Each action has a recorder field: click it and press the new combination, and the menu bar updates immediately. Actions are listed under their own names there: the sidebar toggle is Toggle Table Browser. Filter with the search field, press `Delete` in a recorder field to clear a binding, click the curved-arrow button beside a changed shortcut to restore that one, or **Reset to Defaults** to restore all after a confirmation.

Some actions ship with no default and show as unassigned. That is a command waiting for a binding, not one you cleared, and **Reset to Defaults** leaves it unassigned.

Expand Down
2 changes: 1 addition & 1 deletion features/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ An app update can raise the plugin interface version. A plugin built for an olde
| **Update Now** | A compatible build is in the registry. One click installs it. |
| **Check for Updates…** | The plugin requires a newer app version. Once one is found or downloaded, the button reads **Update Available…** or **Relaunch to Update**, as the app menu does. |
| **Try Again** | No compatible build was found, or the registry could not be reached. The update check also keeps trying on its own. |
| **Remove** | Deletes the rejected plugin from disk. |
| **Remove** | After a confirmation, moves the rejected plugin to the Trash, where you can put it back. Shown only for a plugin you installed, never a bundled one. |

## Managing plugins

Expand Down
2 changes: 1 addition & 1 deletion features/team.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Two routes, and the choice is whether your team already shares a folder. If it d

### Team Library

Right-click a connection and choose **Share > Publish to Team Library…**, or publish saved queries from the Favorites sidebar with **Publish Saved Queries to Team…**. Only the connection definition and the query text are sent, never passwords.
Right-click a connection and choose **Share > Publish to Team Library…**, or publish saved queries from the Favorites sidebar with **Publish Saved Queries to Team…**. Only the connection definition and the query text are sent, never passwords, tunnel commands or startup SQL.

Teammates get the connections in their list the way a Linked Folder delivers them, and shared queries in their Favorites sidebar labeled with whoever published each one. Their app pulls the library every 7 days, and **Settings > License > Team** shows when it last did, with **Refresh** to pull now. A pull that fails keeps what was there and says **Couldn't refresh the team library** with the reason. A pulled connection arrives without its startup SQL, because it lands with no confirmation step and nothing that would run by itself travels with it.

Expand Down
2 changes: 1 addition & 1 deletion integrations/terminal.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -178,7 +178,7 @@ Send one statement per query. SQL Server also accepts a script split at `GO` lin

A database link asks **Open External Database Connection?** before connecting. Check the host, user and database before approving.

For a local connection without SSH or a filter, **Always Allow** remembers the database type, host, database, user and URL `name`. Local hosts include `localhost`, `::1` and `127.x.x.x`. A local socket grant also includes its path. The port is excluded, so a development server may change ports without asking again. Remote hosts and SSH links ask every time.
For a local connection without a filter, an SSH tunnel, an SSH profile, a SOCKS proxy, a tunnel command, Cloudflare or the Cloud SQL Auth Proxy, **Always Allow** remembers the database type, host, database, user and URL `name`. Local hosts include `localhost`, `::1` and `127.x.x.x`. A local socket grant also includes its path. The port is excluded, so a development server may change ports without asking again. A link that opens a saved connection is remembered for that saved connection only. Remote hosts and links through a tunnel or proxy ask every time.

<Frame caption="Only local database links offer Always Allow">
<img className="block dark:hidden" src="/images/link-trust-alert.png" alt="External connection alert showing the target database and approval buttons" />
Expand Down
Loading