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
8 changes: 4 additions & 4 deletions POLICY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Listing policy

Version 1, effective 2026-10-10.
Version 2, effective 2026-11-08.

This policy decides what appears in the TablePro integration directory at [tablepro.app/integrations](https://tablepro.app/integrations) and in this repository's published data.

Expand Down Expand Up @@ -28,7 +28,7 @@ An integration uses only the interfaces in the [developer docs](https://docs.tab

It never reads, writes or deletes TablePro's private files: `connections.json`, `com.TablePro.plist`, `mcp-handshake.json`, TablePro's Keychain items or its SQLite databases. There is no exception and no grace period for new entries. CI scans open-source entries for these paths.

It finds TablePro by bundle identifier `com.TablePro`, not by a fixed install path.
It finds TablePro by bundle identifier `com.TablePro` on a Mac and app ID `app.tablepro.TablePro` on Linux, not by a fixed install path.

## 5. License and source

Expand All @@ -40,15 +40,15 @@ There is no minimum number of stars, installs or downloads.

## 6. Safety settings

An integration may open connections with Safe Mode below the user's default only for local development environments, such as `safeModeLevel=0` for a database on the same Mac. The entry discloses it, and the directory shows it on the entry page.
An integration may open connections with Safe Mode below the user's default only for local development environments, such as `safeModeLevel=0` for a database on the same computer. The entry discloses it, and the directory shows it on the entry page.

## 7. Disclosures

Every entry states:

- what it reads from TablePro (connection list, schema, row data) and what it writes (data, schema);
- whether it lowers Safe Mode;
- where it sends data: nowhere, this Mac only, or the internet, and to whom;
- where it sends data: nowhere, this computer only, or the internet, and to whom;
- whether it needs an account with another service, with a privacy policy link;
- whether it is free, has optional payment, or is paid.

Expand Down
Binary file modified integrations/claude-code/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 7 additions & 5 deletions integrations/claude-code/integration.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"slug": "claude-code",
"name": "Claude Code",
"summary": "Connect Claude Code to your databases through the MCP server built into TablePro.",
"description": "Claude Code runs the bundled tablepro-mcp bridge as a local MCP server. Setup is one claude mcp add command.",
"description": "On a Mac, Claude Code runs the bundled tablepro-mcp bridge as a local MCP server. On Linux, it connects to TablePro's MCP server over HTTP on 127.0.0.1 with an access token. Setup is one claude mcp add command.",
"tier": "official",
"status": {
"state": "active"
Expand All @@ -31,10 +31,12 @@
"url": "https://claude.com/product/claude-code"
},
"minTableProVersion": {
"macos": "0.37.0"
"macos": "0.37.0",
"linux": "0.1.0-beta.1"
},
"platforms": [
"macos"
"macos",
"linux"
],
"categories": [
"ai-clients",
Expand All @@ -53,7 +55,7 @@
"data",
"schema"
],
"accessNote": "Uses the Read & Write token of the bundled bridge. Each connection's External Clients level and Safe Mode still apply.",
"accessNote": "On a Mac it uses the Read & Write token of the bundled bridge, on Linux the access token from the MCP page of Preferences. Each connection's External Clients level and Safe Mode still apply.",
"lowersSafeMode": false,
"network": "internet",
"networkNote": "Claude Code sends tool results, such as connection names, schemas and rows, to its model provider.",
Expand All @@ -74,5 +76,5 @@
"ai"
],
"addedAt": "2026-10-10",
"lastVerifiedAt": "2026-10-10"
"lastVerifiedAt": "2026-11-08"
}
Binary file modified integrations/claude-desktop/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified integrations/cursor/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified integrations/zed/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 7 additions & 5 deletions integrations/zed/integration.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"slug": "zed",
"name": "Zed",
"summary": "Connect Zed's agent to your databases through the MCP server built into TablePro.",
"description": "Zed runs the bundled tablepro-mcp bridge as a local MCP server. Setup is one entry under context_servers in Zed's settings file.",
"description": "On a Mac, Zed runs the bundled tablepro-mcp bridge as a local MCP server. On Linux, it connects to TablePro's MCP server over HTTP on 127.0.0.1 with an access token. Setup is one entry under context_servers in Zed's settings file.",
"tier": "official",
"status": {
"state": "active"
Expand All @@ -31,10 +31,12 @@
"url": "https://zed.dev"
},
"minTableProVersion": {
"macos": "0.37.0"
"macos": "0.37.0",
"linux": "0.1.0-beta.1"
},
"platforms": [
"macos"
"macos",
"linux"
],
"categories": [
"ai-clients",
Expand All @@ -53,7 +55,7 @@
"data",
"schema"
],
"accessNote": "Uses the Read & Write token of the bundled bridge. Each connection's External Clients level and Safe Mode still apply.",
"accessNote": "On a Mac it uses the Read & Write token of the bundled bridge, on Linux the access token from the MCP page of Preferences. Each connection's External Clients level and Safe Mode still apply.",
"lowersSafeMode": false,
"network": "internet",
"networkNote": "Zed sends tool results, such as connection names, schemas and rows, to its model provider.",
Expand All @@ -73,5 +75,5 @@
"ai"
],
"addedAt": "2026-10-10",
"lastVerifiedAt": "2026-10-10"
"lastVerifiedAt": "2026-11-08"
}
16 changes: 11 additions & 5 deletions schema/integration.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -159,17 +159,18 @@
"additionalProperties": false,
"minProperties": 1,
"properties": {
"macos": { "$ref": "#/$defs/version" },
"ios": { "$ref": "#/$defs/version" },
"ipados": { "$ref": "#/$defs/version" }
"macos": { "$ref": "#/$defs/appVersion" },
"linux": { "$ref": "#/$defs/appVersion" },
"ios": { "$ref": "#/$defs/appVersion" },
"ipados": { "$ref": "#/$defs/appVersion" }
}
},
"platforms": {
"description": "TablePro apps this works with, not the host's platforms.",
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": { "enum": ["macos", "ios", "ipados"] }
"items": { "enum": ["macos", "linux", "ios", "ipados"] }
},
"categories": {
"type": "array",
Expand Down Expand Up @@ -310,6 +311,11 @@
"type": "string",
"pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?$"
},
"appVersion": {
"description": "A TablePro release. TablePro for Linux ships betas before 0.1.0, such as 0.1.0-beta.1.",
"type": "string",
"pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?(?:-(?:alpha|beta|rc)\\.(?:0|[1-9][0-9]*))?$"
},
"statusActive": {
"type": "object",
"additionalProperties": false,
Expand Down Expand Up @@ -515,7 +521,7 @@
},
"safeModeNote": { "allOf": [{ "$ref": "#/$defs/plainLine" }], "maxLength": 200 },
"network": {
"description": "Where the integration itself sends data, besides TablePro and the user's databases. local means this Mac only.",
"description": "Where the integration itself sends data, besides TablePro and the user's databases. local means this computer only.",
"enum": ["none", "local", "internet"]
},
"networkNote": { "allOf": [{ "$ref": "#/$defs/plainLine" }], "maxLength": 200 },
Expand Down
10 changes: 10 additions & 0 deletions scripts/tests/test_validate.py
Original file line number Diff line number Diff line change
Expand Up @@ -341,6 +341,16 @@ def test_grace_ending_before_start(self):
self.edit("localwp", lambda d: d["compliance"]["grace"].update(endsAt="2026-10-01"))
self.assertError(self.run_validator(), "must be after startedAt")

def test_linux_with_a_beta_version(self):
self.edit("command-line", lambda d: d.update(platforms=["macos", "linux"],
minTableProVersion={"macos": "0.37.0", "linux": "0.1.0-beta.1"}))
self.assertEqual([f.message for f in self.run_validator().report.errors], [])

def test_app_version_takes_only_a_numbered_pre_release(self):
self.edit("command-line", lambda d: d.update(platforms=["macos", "linux"],
minTableProVersion={"linux": "0.1.0-beta"}))
self.assertTrue(self.run_validator().report.errors)

def test_min_version_for_unlisted_platform(self):
self.edit("command-line", lambda d: d.update(minTableProVersion={"ios": "1.0"}))
self.assertError(self.run_validator(), "ios is not in platforms")
Expand Down
Loading