diff --git a/connections/index.mdx b/connections/index.mdx
index 3924719..5ed9118 100644
--- a/connections/index.mdx
+++ b/connections/index.mdx
@@ -73,6 +73,7 @@ Red for production, green for development. On production, set **Safe Mode** to *
| **Groups** | Folders in the connection list, nested up to three levels. Choose **File > New Group…**, or right-click empty space for **New Group…**. Right-click a group for **Rename**, **Edit Group…**, **New Subgroup…**, **Color**, **Move Group To**, and **Delete Group…**. **Edit Group…** changes the name, icon, color and parent group in one sheet. Deleting a group deletes its subgroups too and leaves the connections inside ungrouped rather than deleted |
| **Tags** | Several per connection, each with a name and color. Type a tag's name in the search field and pick it to filter by it, or choose tags from **Filter by Tag** in the **View Options** menu. With two or more chosen, **Match** switches between any and all of them, and **Clear Filters** removes them |
| **Favorites** | Right-click a connection and choose **Add to Favorites**, or drag it onto the **Favorites** header. Favorites gather in a section at the top while the connection keeps its place in its group |
+| **Projects** | One project per product, each holding groups and connections. Choosing one from the pop-up button at the leading edge of the toolbar narrows the list, its search, **Favorites** and **Recent** to it. See [Projects](/connections/projects) |
| **Recent** | The five connections you opened last, favorites left out. Right-click one for **Remove from Recent**, or the section header for **Clear Recent**. To hide the section, turn off **Show recent connections** in [General settings](/customization/general-settings#connections) |
A connection's icon, group, tags, and favorite sync through iCloud, and so does a group's icon, to the iPhone and iPad app as well, unless it is marked local only. See [iCloud Sync](/features/icloud-sync).
@@ -124,4 +125,4 @@ Right-click a connection to edit or delete it, or select it and press `Delete`.
Connections are stored in `~/Library/Application Support/TablePro/connections.json` with their passwords in the macOS Keychain, so copying that file to another Mac restores the connections without the passwords. Each save keeps the file it replaces as `connections.json.backup`. A connection this version cannot read is kept as it is and the others load; it stays in the file, or moves to `connections.json.unreadable-records` when the file changed outside TablePro. A file that no longer reads as a list is restored from the backup, and the damaged copy is kept as `connections.json.unreadable`.
-Right-clicking the Dock icon lists saved connections under **Open Connection**.
+Right-clicking the Dock icon lists saved connections under **Open Connection**: those of the active [project](/connections/projects), or all of them in **All Connections**.
diff --git a/connections/projects.mdx b/connections/projects.mdx
new file mode 100644
index 0000000..ede6ea4
--- /dev/null
+++ b/connections/projects.mdx
@@ -0,0 +1,87 @@
+---
+title: Projects
+description: Keep one product's connections, saved queries and history apart from the rest
+---
+
+The pop-up button at the leading edge of the welcome window's toolbar names what the list shows. It starts on **All Connections**, which is built in and shows everything. Choose a project there, or under **File > Project**, and the connection list narrows to it, along with its search, **Favorites** and **Recent**.
+
+
+
+
+
+
+## Create a project
+
+
+
+ It is at the foot of the pop-up button's menu and under **File > Project**.
+
+
+ Type a name and click **Create**. A name another project holds is refused, whatever its case.
+
+
+ The list switches to the new project and reads **No Connections in** with its name. Add a connection with the button under that, or go back to **All Connections** and move connections in.
+
+
+
+## Move connections into a project
+
+A project holds top-level groups and ungrouped connections. Right-click one and choose **Move to Project**, then the project, or **None** to take it out of every project. Select several first to move them together. **Edit > Undo** puts a move back.
+
+- A group takes its subgroups and their connections along.
+- A connection inside a group has no **Move to Project**. Move its top-level group, or take the connection out of the group first.
+- A connection is in one project at most.
+
+While a project is active, a new connection, a new group and an import land in it. An imported file that names a project of its own keeps it: a project with that name is reused, and a missing one is created.
+
+## What follows the active project
+
+| Place | What it lists |
+|---|---|
+| Welcome window | The project's groups and connections. Search, **Favorites** and **Recent** stay inside it |
+| [**Switch Connection**](/connections#switch-connections-and-databases) | The project's saved connections. A connection that is already open stays listed |
+| [Query History](/features/query-history#filtering) and [Query Insights](/features/query-insights#filtering) | With the scope on all connections, the queries run on the project's connections |
+| [Open Quickly](/features/open-quickly#across-connections) | Saved and recent queries of the project's connections, plus the window's own connection |
+| [Compare & Sync](/features/compare-sync) and [Copy and duplicate](/features/copy-objects) | The project's connections in the connection pickers |
+| The connection form | The project's groups under **Group** |
+| The Dock menu | The project's connections under **Open Connection** |
+| **File > Export > Export Connections…** | The project's connections |
+
+Open windows stay open when you switch. A `tablepro://` link and a saved Shortcut still open a connection of another project, since they name it by id.
+
+A search that finds nothing inside a project offers **Search All Connections**, which switches to **All Connections** and keeps the text you typed.
+
+## Manage projects
+
+Choose **Manage Projects…** from the pop-up button or from **File > Project**.
+
+
+
+
+
+
+| To | Do this |
+|---|---|
+| Add | Click **+** and type the name |
+| Rename | Edit the name in its row and press `Return` |
+| Reorder | Drag a row. The pop-up button and **File > Project** list projects in this order |
+| Delete | Select the project and click **−**, then **Delete** |
+
+Deleting a project keeps its connections and groups. They leave the project and show under **All Connections**, and when the deleted project was the active one, so does the list.
+
+## Per device
+
+Projects, and the one that is active, stay on the Mac they were set on. iCloud Sync does not carry them.
+
+## Outside clients
+
+Switching project also narrows what other programs are offered:
+
+| Client | What follows the project |
+|---|---|
+| [MCP clients](/developers/mcp-tools#the-active-project) | `list_connections` and the connections resource. A call that names a connection of another project by id is refused |
+| The [`tablepro` command](/integrations/terminal#what-a-query-may-do) | `connections`, and the names and ids `-c` accepts |
+| [AppleScript](/developers/applescript#objects) | The `connections` list |
+| [Shortcuts](/integrations/shortcuts) | The connections the picker offers. A shortcut that already holds a connection still runs |
+
+The assistant inside TablePro is not narrowed: it works on its own window's connection. A project only narrows. Tokens, **External Clients** and approvals apply as before, so a client reaches nothing through a project that it could not reach without one.
diff --git a/developers/applescript.mdx b/developers/applescript.mdx
index 38c481c..ee06356 100644
--- a/developers/applescript.mdx
+++ b/developers/applescript.mdx
@@ -51,7 +51,8 @@ application
```
`connections` lists every saved connection whose **External Clients** level is not Blocked, sorted
-by name. Reach one by name or by id.
+by name. With a [project](/connections/projects) active, it lists that project's connections only.
+Reach one by name or by id. An id also reaches a connection of another project.
```applescript
tell application "TablePro"
diff --git a/developers/mcp-protocol.mdx b/developers/mcp-protocol.mdx
index 92651da..2176219 100644
--- a/developers/mcp-protocol.mdx
+++ b/developers/mcp-protocol.mdx
@@ -329,7 +329,7 @@ TablePro's own error codes live in `-33000` and above. The `-32000` block is fro
| `-33003` | 200 | Request timeout. The statement or the handler deadline ran out. |
| `-33005` | 413 | Payload too large. The body cap is 10 MB. |
| `-33006` | 503 | Server disabled. |
-| `-33007` | 403 | Forbidden. Token scope, connection allowlist, AI policy, or external access rejected the call. |
+| `-33007` | 403 | Forbidden. Token scope, connection allowlist, AI policy, external access, or [the active project](/developers/mcp-tools#the-active-project) rejected the call. |
| `-33008` | 401 | Token expired. |
| `-33009` | 401 | Unauthenticated. No token, or an unknown or revoked one. |
| `-33010` | 429 | Rate limited. Carries `Retry-After`. |
diff --git a/developers/mcp-tools.mdx b/developers/mcp-tools.mdx
index 14e13cd..66bb975 100644
--- a/developers/mcp-tools.mdx
+++ b/developers/mcp-tools.mdx
@@ -41,6 +41,15 @@ Past the scope, a call clears three more gates:
2. **Connection policy.** **External Clients** set to **Blocked** hides the connection: `list_connections` omits it and any tool that names it is refused. An AI policy of **Never** does the same, except that [`purpose: "display"`](#listing-for-display) still lists it. Otherwise the first call that touches a connection asks the user, as often as **Settings > MCP > Approval** says. That question is always a dialog on the user's Mac, never an elicitation: a client that could answer it could also grant itself the connection. It has no deadline, so the client owns the timeout, and a refusal stands for 60 seconds before the question can be put again.
3. **Safe Mode.** A write goes through the connection's Safe Mode, which may ask the user to confirm it or to authenticate. See [Approvals](/developers/mcp-protocol#approvals-and-input-required).
+### The active project
+
+When the user has a [project](/connections/projects) active in TablePro, `list_connections` and the [`tablepro://connections`](/developers/mcp-resources) resource hold that project's connections only. A tool that names a connection of another project by id is refused with `-33007` and the text "This connection is in another project. Switch to that project or to All Connections in TablePro to reach it."
+
+- The user switches project in the app, so the answer can change between two calls of one client.
+- With **All Connections** chosen, nothing is narrowed.
+- The scope only narrows. The token, the allowlist, the connection policy and Safe Mode are checked as before.
+- TablePro for Linux and Windows return a tool error with the code `out_of_scope` instead. See [Linux tools](/integrations/mcp-clients#linux-tools).
+
`completion/complete` clears the same connection policy without asking: on a connection this client is not approved for, it completes nothing. See [Context matters](/developers/mcp-prompts#context-matters).
A call that opens a connection may also need approval on the Mac for a pre-connect script, environment variables, or [local sign-in credentials](/connections/connection-form#sign-ins-from-this-mac). A refusal returns `denied`; an unanswered prompt returns `timeout`.
@@ -91,7 +100,7 @@ To read a value that was cut, select part of it with a narrower query. To get mo
`switch_database` and `switch_schema` move what the user sees: the sidebar, and the tab strip, which lists the tabs of the database or schema the connection is on. The user's other tabs stay open under their own database.
-`list_connections` omits connections blocked for external clients, connections whose AI policy is **Never**, and connections outside the token's allowlist. Its `database` is the session's browsed database when connected, the saved default otherwise.
+`list_connections` omits connections blocked for external clients, connections whose AI policy is **Never**, connections outside the token's allowlist, and connections outside [the active project](#the-active-project). Its `database` is the session's browsed database when connected, the saved default otherwise.
The labels the user gave a connection come with it, so a client can show the list the way the app does:
diff --git a/docs.json b/docs.json
index 6247cc7..20b3130 100644
--- a/docs.json
+++ b/docs.json
@@ -231,6 +231,7 @@
"icon": "plug",
"pages": [
"connections/index",
+ "connections/projects",
"connections/connection-form",
"connections/urls",
"connections/ssh-tunneling",
@@ -465,6 +466,7 @@
"pages": [
"windows/data-grid",
"windows/browsing",
+ "windows/projects",
"windows/account"
]
}
diff --git a/features/mcp.mdx b/features/mcp.mdx
index bd4fd46..cb44cb9 100644
--- a/features/mcp.mdx
+++ b/features/mcp.mdx
@@ -111,6 +111,7 @@ Every request needs a token, including one from your own Mac. The server supplie
- Clients work through your saved connections. Passwords never leave the Keychain and are not readable over MCP.
- AI access is set per connection, including blocking a connection from external clients entirely. A blocked connection is not even listed.
+- With a [project](/connections/projects#outside-clients) active, clients are offered that project's connections only. A project narrows the list and grants nothing.
- Tokens carry scopes and can be limited to named connections. A request without one gets `401`, from your own Mac too. See [No token, no access](/developers/tokens#no-token-no-access).
- Writes go through the connection's [Safe Mode](/features/safe-mode#external-clients). Destructive statements need a full-access token and approval every time. See [the confirmation tool](/developers/mcp-tools#writing-data).
- Reads use the driver's read-only mode where supported. Statements that access files or run server-side code are refused. [What Read Only allows](/developers#what-read-only-allows) covers engine limits and other refusals.
diff --git a/features/open-quickly.mdx b/features/open-quickly.mdx
index d8cbefa..ad3ba89 100644
--- a/features/open-quickly.mdx
+++ b/features/open-quickly.mdx
@@ -78,7 +78,7 @@ The **Connections** and **Queries** scopes reach into every connected window, an
An empty search groups results under each connection's name. Once you type, everything is ranked in one list and each row names the connection, database, and schema it belongs to; the path is matched too, so typing a connection's name narrows the list to it. Opening a result brings that connection's window forward.
-**Queries** holds your saved queries plus up to 200 recent ones, drawn evenly across connections rather than by raw recency, with execution times on the recent rows. Global saved queries open in the connection you opened the panel from, which stays listed even while it is reconnecting.
+**Queries** holds your saved queries plus up to 200 recent ones, drawn evenly across connections rather than by raw recency, with execution times on the recent rows. Global saved queries open in the connection you opened the panel from, which stays listed even while it is reconnecting. With a [project](/connections/projects) active, the queries of other connections come from that project only.
diff --git a/features/query-history.mdx b/features/query-history.mdx
index 999d238..a95b09c 100644
--- a/features/query-history.mdx
+++ b/features/query-history.mdx
@@ -26,7 +26,7 @@ Recent queries also appear in [Open Quickly](/features/open-quickly). For the su
| Control | What it does |
|---------|--------------|
-| Scope | This connection, or all connections |
+| Scope | This connection, or all connections. With a [project](/connections/projects) active, all connections means the project's |
| Source | Which parts of the app a query came from |
| Date | Last hour, today, last 7 days, last 4 weeks, all time |
| Outcome | Any, succeeded, or failed |
diff --git a/features/query-insights.mdx b/features/query-insights.mdx
index 540cc33..1756741 100644
--- a/features/query-insights.mdx
+++ b/features/query-insights.mdx
@@ -78,7 +78,7 @@ Two things stay apart: table and column names keep their capitalization, since `
| Control | What it does |
|---------|--------------|
-| Scope | This connection, or all connections |
+| Scope | This connection, or all connections. With a [project](/connections/projects) active, all connections means the project's |
| Source | Which parts of the app the queries came from |
| Date | Last hour, today, last 7 days, last 4 weeks, all time |
diff --git a/images/connection-projects-dark.png b/images/connection-projects-dark.png
new file mode 100644
index 0000000..6390077
Binary files /dev/null and b/images/connection-projects-dark.png differ
diff --git a/images/connection-projects-manage-dark.png b/images/connection-projects-manage-dark.png
new file mode 100644
index 0000000..f0f396c
Binary files /dev/null and b/images/connection-projects-manage-dark.png differ
diff --git a/images/connection-projects-manage.png b/images/connection-projects-manage.png
new file mode 100644
index 0000000..2d60298
Binary files /dev/null and b/images/connection-projects-manage.png differ
diff --git a/images/connection-projects.png b/images/connection-projects.png
new file mode 100644
index 0000000..4dafc05
Binary files /dev/null and b/images/connection-projects.png differ
diff --git a/images/windows-connection-projects-dark.png b/images/windows-connection-projects-dark.png
new file mode 100644
index 0000000..6d4c65d
Binary files /dev/null and b/images/windows-connection-projects-dark.png differ
diff --git a/images/windows-connection-projects.png b/images/windows-connection-projects.png
new file mode 100644
index 0000000..0502a23
Binary files /dev/null and b/images/windows-connection-projects.png differ
diff --git a/integrations/mcp-clients.mdx b/integrations/mcp-clients.mdx
index a0acb5b..0643889 100644
--- a/integrations/mcp-clients.mdx
+++ b/integrations/mcp-clients.mdx
@@ -205,6 +205,8 @@ Call it again to check for `open`.
Arguments marked `?` are optional. Unknown arguments are rejected.
+With a [project](/linux/connect#projects) picked in the app, `list_connections` holds that project's connections. A call that names a connection of another project by id fails with a tool error whose text starts with `out_of_scope`. Picking that project, or **All Connections**, in the app clears it.
+
| Tool | Arguments | Result |
|---|---|---|
| `list_connections` | None | Saved connections visible to clients, their open state, external access and Safe Mode |
@@ -301,7 +303,7 @@ The bridge is newer than the app it found. Update TablePro.
### Forbidden (`-33007`)
-**External Clients** is **Blocked**, the connection's AI policy is **Never**, or the token's allowlist excludes it. Any of the three also hides the connection from `list_connections`, except that a launcher token granted [`connections:display`](/developers/mcp-tools#listing-for-display) still lists a connection whose AI policy is **Never**.
+**External Clients** is **Blocked**, the connection's AI policy is **Never**, the token's allowlist excludes it, or it is outside the [project](/connections/projects) active in TablePro. Any of the four also hides the connection from `list_connections`, except that a launcher token granted [`connections:display`](/developers/mcp-tools#listing-for-display) still lists a connection whose AI policy is **Never**.
### Unauthenticated (`-33009`)
diff --git a/integrations/shortcuts.mdx b/integrations/shortcuts.mdx
index 16c5dbb..1420779 100644
--- a/integrations/shortcuts.mdx
+++ b/integrations/shortcuts.mdx
@@ -24,7 +24,7 @@ The iOS app's build is under **Settings > About**; it ships on its own schedule,
In a new shortcut, add **Run Query** and type the statement, such as `SELECT count(*) FROM orders`.
- **Connection** lists every saved connection whose **External Clients** level is not Blocked.
+ **Connection** lists every saved connection whose **External Clients** level is not Blocked, or those of the active [project](/connections/projects). A shortcut keeps the connection it was saved with.
**Database or Schema** is optional and works as it does for the insert actions.
diff --git a/integrations/terminal.mdx b/integrations/terminal.mdx
index 992cf41..f79c2fb 100644
--- a/integrations/terminal.mdx
+++ b/integrations/terminal.mdx
@@ -169,7 +169,7 @@ Pairing refusal or expiry also exits 3. See [Status and pairing](#status-and-pai
The command follows the [MCP connection access rules](/features/mcp#connection-access):
-- **Blocked** connections, an AI policy of **Never**, and connections outside the token's allowlist are hidden. Naming one exits 2.
+- **Blocked** connections, an AI policy of **Never**, connections outside the token's allowlist, and connections outside the active [project](/connections/projects) are hidden. Naming one exits 2.
- Writes need both a **Read & Write** token and **Read & Write** external access. `--read-only` still refuses them.
- **Approval** in **Settings > MCP** controls connection approval. [Safe Mode](/features/safe-mode) also applies to writes.
- Destructive statements such as `DROP`, `TRUNCATE`, `ALTER ... DROP` and `DELETE` without `WHERE` are refused. Run them in the app. Statements that access files or run server-side code are also refused.
diff --git a/ios/index.mdx b/ios/index.mdx
index b5d72e7..6961490 100644
--- a/ios/index.mdx
+++ b/ios/index.mdx
@@ -58,13 +58,14 @@ Cassandra, BigQuery, Spanner, Snowflake and the rest have no iOS driver. Their c
## The connection list
-Favorites come first, then **Recent** with the five connections opened last, then your groups, nested the way the Mac nests them. The **More** menu holds **Sort By** (**Manual**, **Name**, **Database Type**, **Last Connected**), **New Group**, **Manage Tags**, **Open Sample Database**, and import and export. Type a tag's name in the search field to filter by it; with two tags or more chosen, **Match All Tags** appears in the **More** menu.
+Favorites come first, then **Recent** with the five connections opened last, then your groups, nested the way the Mac nests them. The **More** menu holds **Sort By** (**Manual**, **Name**, **Database Type**, **Last Connected**), **New Group**, **Manage Tags**, **Manage Projects…**, **Open Sample Database**, and import and export. Type a tag's name in the search field to filter by it; with two tags or more chosen, **Match All Tags** appears in the **More** menu.
| To | Do this |
| --- | --- |
| Favorite a connection | Swipe right on it, or touch and hold and choose **Add to Favorites** |
| Rename | Touch and hold, choose **Rename**, type the name, and tap **Done** |
| Move into a group | Touch and hold and choose **Move to Group**, or drag the row onto a group |
+| Move into a project | Touch and hold an ungrouped connection or a top-level group and choose **Move to Project** |
| Reorder | Tap **Edit** and drag the handles, with **Sort By** on **Manual** |
| Change several at once | Tap **Edit**, select the rows, and tap **Move**, **Favorite** or **Delete** |
| Delete | Swipe left, or touch and hold and choose **Delete** |
@@ -77,6 +78,23 @@ Favorites come first, then **Recent** with the five connections opened last, the
A connection, group or tag form with unsaved changes stays open when swiped down, and **Cancel** asks before it discards them.
+### Projects
+
+A project keeps one product's connections apart. Choose **More > Manage Projects…**, tap **New Project…**, and name it. From then on the list's title is a menu: tap it and pick the project, or **All Connections** for everything. **Manage Projects…** is in that menu too, and **Edit** moves into the **More** menu.
+
+| To | Do this |
+| --- | --- |
+| Put a connection or a group in a project | Touch and hold it and choose **Move to Project**, then the project, or **None** to take it out |
+| Rename a project | Open **Manage Projects…** and tap the project |
+| Reorder projects | Touch and hold a row in **Manage Projects…**, then drag it |
+| Delete a project | Swipe left on it in **Manage Projects…**. Its connections are kept and show under **All Connections** |
+
+**Move to Project** is offered on an ungrouped connection and on a top-level group. A group takes everything in it along, and a connection inside a group follows its top-level group. A connection is in one project at most.
+
+With a project chosen, the list, its search, **Favorites**, **Recent**, **Move to Group** and export show that project only. So do the **Quick Connect** widget, Spotlight and the connections a Shortcuts action offers. A shortcut that already holds a connection, a widget tap and a `tablepro://` link still open a connection of another project. **Open Sample Database** is in the **More** menu under **All Connections** only.
+
+A new connection, a new group and an import land in the project you are in, unless the imported file names a project of its own. A search with no match offers **Search All Connections**. The project you chose, and the projects themselves, stay on this device.
+
## The sample database
**Open Sample Database** sits on the empty list and in the **More** menu. It opens Chinook, a SQLite database of a music store, at its **Track** table, with no server to set up. The sample stays on this device: it never syncs, goes into a `.tablepro` file or hands off to another device. To throw away your edits, touch and hold **Chinook (Sample)** and choose **Reset Database**.
diff --git a/linux/command-line.mdx b/linux/command-line.mdx
index de39153..5945833 100644
--- a/linux/command-line.mdx
+++ b/linux/command-line.mdx
@@ -130,7 +130,7 @@ A pipe closed by its reader, such as `| head`, exits 0.
## What a query may do
-A connection's **External Clients** setting applies to every command that uses it. **Blocked** hides the connection; naming it exits 2. **Read Only** is the default and refuses writes.
+A connection's **External Clients** setting applies to every command that uses it. **Blocked** hides the connection; naming it exits 2. So does naming a connection outside the [project](/linux/connect#projects) picked in the app: `connections` lists that project only. **Read Only** is the default and refuses writes.
With **Read & Write**, each write still needs **Run** in the connection's window. Safe Mode also applies; **Read-Only** refuses writes. `--read-only` refuses a write before it asks for approval.
diff --git a/linux/connect.mdx b/linux/connect.mdx
index 156c3c0..7c42aa3 100644
--- a/linux/connect.mdx
+++ b/linux/connect.mdx
@@ -57,6 +57,38 @@ Redshift, CockroachDB, TiDB, OceanBase and Databend are untested on Linux. Suppo
For a MongoDB replica set or cluster behind a `mongodb+srv://` address, turn on **DNS Seed List**. **Authentication Database (optional)** names the database that holds the user.
+## Projects
+
+The menu button at the start of the connection list's header bar names what the list shows. **All Connections** is built in and shows everything. Pick a project there, or under **Project** in the main menu, to see only its connections.
+
+
+
+ Choose **New Project…** from the button's menu, type a name, and click **Create**.
+
+
+ Right-click an ungrouped connection or a top-level group, choose **Move to Project**, then the project. **No Project** takes it out again.
+
+
+ Pick the project, or **All Connections**, from the button's menu.
+
+
+
+A group takes its subgroups and connections along. A connection inside a group follows its top-level group, so it has no **Move to Project** of its own. A connection is in one project at most.
+
+With a project picked, these show its connections only:
+
+- The connection list, with its search, favorites and recent connections.
+- The connection tree in each window's sidebar. A connection the window already holds keeps its row.
+- **Query History** and **Saved Queries**.
+- **Export Connections**, which writes the project's groups and connections.
+- The [MCP server](/integrations/mcp-clients#linux-tools) and the [command line](/linux/command-line#what-a-query-may-do).
+
+Open connections stay open when you switch, and a link still opens a connection of another project. A new connection, a new group, an imported file and an import from another app land in the picked project, unless the file names a project of its own.
+
+A search with no match inside a project offers **Search All Connections**, which switches to **All Connections** and keeps the search text. An empty project reads **No Connections in** with its name, over a button that adds a connection.
+
+**Manage Projects…** lists every project with its connection count. Click a row to rename it, **Move Up** or **Move Down** to reorder, and **Delete Project** to remove it. Deleting keeps the project's connections and groups under **All Connections**. The picked project is saved per computer.
+
## Options
| Row | Sets |
diff --git a/windows/projects.mdx b/windows/projects.mdx
new file mode 100644
index 0000000..3ab85f0
--- /dev/null
+++ b/windows/projects.mdx
@@ -0,0 +1,57 @@
+---
+title: Projects
+description: Group saved connections by product on the Connections page of TablePro for Windows and show one product at a time
+tag: "Preview"
+---
+
+A drop-down button beside the **Connections** title names the project the page shows. **All connections** is built in and lists every connection. **File > Project** holds the same choices in every window.
+
+
+
+
+
+
+## Create and switch
+
+
+
+ It is in the drop-down button's menu and under **File > Project**. Type a name. A name another project has is refused.
+
+
+ Right-click an ungrouped connection or a top-level group, choose **Move to project**, then the project. **No project** takes it out again.
+
+
+ Pick the project, or **All connections**, from the button's menu. While the Connections page shows, the title bar names the project.
+
+
+
+A group takes its subgroups and connections along. A connection inside a group moves with its group, so move the group instead. A connection is in one project at most.
+
+## What follows the project
+
+| Follows the project | Stays as it was |
+|---|---|
+| The connection tree, its search, **Favorites** and **Recent** | Open connections and the rail |
+| **Move to group** and the connection form's group list | Sessions restored at startup |
+| Export of connections | `tablepro://` links |
+| The query history of a file opened without a saved connection | A saved connection's own history and saved queries |
+
+A new connection, a new top-level group and an import land in the project you are in, unless an imported file names a project of its own. A duplicate stays beside the connection it was made from.
+
+A search with no match inside a project offers **Search all connections**, which switches to **All connections** and keeps the text. An empty project reads **No connections in** with its name and offers **New connection**.
+
+The [MCP server](/developers/mcp-tools#the-active-project) lists the project's connections to outside clients.
+
+## Manage projects
+
+Choose **Manage projects...** from the button's menu or from **File > Project**. It appears once a project exists. Select a project, then:
+
+| To | Do this |
+|---|---|
+| Rename | Edit the name in the box and click **Rename** |
+| Reorder | Click **Move up** or **Move down** |
+| Delete | Click **Delete**, then **Delete** again in the flyout |
+
+Deleting a project keeps its connections and groups. They show in **All connections**.
+
+The project you picked is saved per PC.